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FeatureArtide 

DS-69B VIDEO 

by STEVE RICKETTS 

w 

WW hen I bought a DS-69A video 
digitizer from Micro Works five years ago, 
I was quite happy with the method used to 
control the brightness of the image. This 
was done through software, and there were 
no knobs I had to fiddle with. Then came the 
C0C0 3 and the DS-69B upgrade, which 
also uses software control for image bright- 
ness. There are times, however, when it 
sure would be nice to have a brightness 
setting somewhere between those supported 
by the software. 

The need for finer level control is espe- 
cially strong now that it's possible to create 
beautiful 4096-color (simulated) pictures 
with the DS-69B. Such images are created 
by using three individual colored screens: 
red, green and blue. The brightness levels 
of the blue and green scans are critical for 
an accurate rendition of the colors con- 
tained in the image you're digitizing, so I 
had to find a way co overcome the software 
control. (Those who are interested in creat- 
ing simulated 4096-color images with the 
DS-69B and a videocamera are welcome to 
contact me for more information on the 
process.) 

At the suggestion of Richard Trasborg 



and Michael Trammell, I decided to build a 
simple circuit to regulate the signal before 
it enters the digitizer, instead of relying on 
the software to handle it after the fact. There 
are many ways such a circuit could be 
constructed (some simpler, some morecom- 
plicatcd), so I'll just explain what I did to 
build mine. Fortunately I was able to con- 
struct this little project using only parts 
from my junk box. But even if you use all 
new parts from your local Radio Shack, the 
project should cost no more than $10. In 
addition, while 1 use the level control with 
the DS-69B, it works well with older mod- 
els of the DS-69 and earlier CoCos. 

Under Construction 

The basic concept of the level control is 
to short the positive and negative sides of 
the video input signal, using varying 
amounts of resistance. To get the variable 
resistance, I used a 5K linear-taper potenti- 
ometer. The circuit diagram for the level 
control is shown in Figure 1 . All the parts 
needed are listed in Figure 2. Except for the 
Y cable, all these parts are mounted in a 
mini projeci box. 
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now flakes are crystals that are formed when 
water molecules freeze and melt as they rise 
and fall in the clouds. They form in apparently 
random six-sided shapes, then fall to the earth. 

Flake Maker is a BASIC09 program that 
draws random six-sided shapes, simulating 
the appearance of snow flakes. Actually, a 
couple of different procedures are used to 
make the Flake Maker system work. These 
programs use the graphics capabilities of OS- 
9 Level II on the CoCo 3. 

Listing 1 contains the two main procedures 
forming the Flake Maker system. The first of 
these, Flake_Maker, allows the user to select 
the background color. It also repeatedly runs 
the second procedure, Flake, which generates 
the individual snowflakes. The procedure 
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NX-1000 Conversions and 512K 

Editor: 

I am trying to convert Color Graphic 
Banner (May 1 984, Page 4 1 ) for my Star 
NX- 1 000 Color printer but cannot get it to 
work properly. The program was originally 
designed to run on the CGP-220. When I 
change the control codes to those for my 
printer, all it does is print small letters in the 
color I picked. I would greatly appreciate 
any help. 

I would also like to know where I can get 
replacement chips for the CoCo 3 512K 
upgrade. I have the Tandy upgrade, but 
Radio Shack's chips are priced too high for 
my budget. 

David Sckirka 

1687 N.Michigan. Lot 106 

Plymouth. IN 46563 

The CGP-220 uses such a unique set of 
control codes that it would he a major 
undertaking to alter the program for use 
with another printer. On the other hand, 
perhaps another reader has already done 
this or would he willing to give it a shot. 
Also, consider other banner printing pro- 
grams; Zebra offers one. as does Sub-Etha, 
whose products are available through Co- 
coPRO!. 

Access to 51 2K? 

Editor: 

I am writing a new program for the 
CoCo 3, and I need to gain access to the 
computer's full complement of 128K (or 
even 512K). I want to do this via machine 
language, but I need some help. I would 
appreciate hearing from others who have 
such experience and knowledge. 

David Polonsky 

4 Tudor Court, Apt. IS 

800 North Broad Street 

Elizabeth. NJ 07208 

Wants to Upgrade Up North 

Editor: 

I am taking a college course in electron- 
ics and want to use my CoCo as a word 
processor (and for any other applications I 
can). The problem is that 1 live in a small 
town in northern Ontario, and it is hard to 
find anything for the CoCo up here. 

1 have a Tandy Color Computer 3 and an 
FD-50 1 disk drive. I am looking for a 5 1 2K 
(or bigger) upgrade kit, an extra disk drive, 
a printer and any available software. 1 have 
checked at the Radio Shack stores in Can- 
ada, but the employees there seem to be 
interested only in selling new computers. 
not in supporting the CoCo. I have enjoyed 
using my CoCo and feel it is "'big enough" 
for what I need. 

Robert llynds 

P.O. Box 1307 

llaileybury. ON P0.1 1K0 

Canada 

Many of the products you mention are 
available through advertisers in THE RAIN- 
BOW. Owl- Ware offers disk drives and other 
hardware items, and CoCoPRO! carries 
Simply Better, which to the best of out- 
knowledge is the only currently available 
Disk BASIC word processor. 



The DMP-105 and Color File U 
Editor: 

First, thank you for an excellent maga- 
zine I plan to renew my subscription. The 
support available through THE rainbow is 
incredible, and things such as the 6309 chip 
paint a bright future for the beloved CoCo. 

I am having a problem with the Color 
File 11 Program Pak. I am able to save and 
load files to cassette but am unable to print 
the files on my DMP-105 printer (which is 
set at 2400 baud) even though I set the print 
options to match. Any help would be greatly 
appreciated. 

Also, in past issues of THE RAINBOW I 
have seen programs that transfer ROM Paks 
to disk, but I haven 't seen any such programs 
lately. I am unable to check on Delphi or 
other BBSs since I don't have a modem. 

Thomas F. Williams 

Quarters 2944-D 

Quantico. VA 22134 

Item 7 on the Printer Options menu of 
Color File II controls the baud rale at which 
data is sent to the printer. The default value 
is 88 for 600 baud. To tell the computer to 
send at 2400 baud, change this value to 18. 

While there have been a few ROM-Pak 
transfer programs in the past, we haven't 
seen many new arrivals in this area. Most of 
the information being passed around at this 
point deals with breaking the copy protec- 
tion schemes used on later games marketed 
by Tandy — a procedure we don't support. 
Further, according to the software license 
granted to purchasers of ROM Paks. trans- 
ferring the programs to different media (e.g.. 
disk) is illegal. 

Needs a Disk Drive 

Editor: 

Am I in a bottomless pit? I have a 5 1 2K 
CoCo 3 with a cassette recorder. This is a 
last-chance attempt to find a disk drive for 
my system. I could use any information or 
addresses that might help me find one. Names 
of companies that might have one on a back 
shelf would also be much appreciated. Thank 
you. 

James Kirby, Jr. 

P.O. Box 387 

Elgin, OR 97827 

Does any one happen to have an extra 
disk-drive system they'd be willing to part 
with to help a desperate CoCo user? 

Easy storage for Pecks and Pokes 

Editor: 

In rereading older issues of THE rain- 
bow. I see a lot of great peeks and pokes. To 
store them, I enter them as basic, lines, using 
the addresses for line numbers. For example, 
following are two lines from my pokes file: 

65495 ' Poke.O: High Speed - PIA 
65497 ' Poke.O: Double High-Spee 
d SAM blows CC2 VDG 

This method automatically puis Ihe peeks 
and pokes in numeric order, making them 
easy to find. If you choose to do this, make 
sure you use the REM marker. Also, don't 
renumber the program with RENIM, or you'll 
be sony! 

Charles Scanlon 

2 Eagle Lane 

Simsbury, CT 06070-1703 

Reviewing Reviews 

Editor: 

I am very pleased with the review of my 
product. The CoCo Collection. However, I 
want to let you know the description of the 
Lock program was not clear. The reviewer 
was correct in writing that it is a "security 
program," but he failed to say that Lock is 



intended for file security rather than com 
puter security. The program is designed so 
lhal important software could be locked 
and executed or unlocked only by the per- 
son who enters the correct password. 

I would also like to note that the program 
DOS Commands has been updated. Until 
now the program displayed the directory 
only until it reached a killed file. Now it 
displays the entire directory. 

In addition, I recently added a new 
game. Scramble, to the collection. Scramble 
supports up to nine players. Each player is 
given 10 random letters from which he 
must build the largest possible word. A 
number of people have tried it, and all 
seemed to like it. 

Finally, I am working on a couple of 
other programs, including one 1 call Typ- 
ing Teacher. As you might have guessed, 
it is a program designed to teach novices 
how to type. A lot of work went into 
creating effective typing exercises, and the 
program has been proven to work. 

Sheldon Parsons 

P.O.Box 117 

Beaumont 

N.D. Bay. NF AOJ IA0 

Canada 

Looking for GMX 

Editor: 

I am having considerable trouble find- 
ing an address for GMX (formerly Gimix 
Systems). Thai company produced a mi- 
cro-mainframe called the 20/20, and I 
would like to contact them. Do you by any 
chance have ihis address? 

Ray Hightower 

Price Daniel Unit 

5938 F.M. 1673 

Snyder. TX 79549 

We sure do. You can contact GMX at 
3223 Arnold Lane. Northbrook, IL 60062- 
2406, (708) 559-0909. 

D.L. Logo on the CoCo 3 
Editor: 

Recently while rummaging through 
close-out software at a Radio Shack store, 
I found and purchased a copy of D.L. Logo. 
When I attempted to run it on my CoCo 3, 
all 1 got was a garbled screen. Can D.L. 
Logo be mn on a CoCo 3, or did I not load 
it properly? If the disk is damaged, is there 
anywhere I can obtain a replacement or 
copy? 

I am also having a lot of difficulty using 
my DCM-6 modem, and the Radio Shack 
folks haven't been able to help at all. Any 
suggestions? 

Ron Hyz 

51 13-1 3th Avenue S. 

Gulfport.FL 33707 

The OS-9 Kernel on the D.L. Logo disk 
is for Level I, which cannot be directly 
booted on the CoCo 3. The easiest way to 
use D.L. Logo on a CoCo 3 is to first hoot 
OS-9 Level II. then insert lite D.L. Logo 
disk and proceed as normal. 



Looking for OS-9 Languages 

Editor: 

I learned that, in addition to BASIC09. 
OS-9 supports Pascal, assembly language 
and C. However. I have seen no ads in THE 
rainbow from companies offering these 
compilers. Can you tell me if they are 
available and where I can get them? 

B.N. Grcgoire 

2006 de Cambrai 

Si-Bruno de Montarvitle. PQ J3V2.I3 

Canada 

The OS-9 compilers for Pascal and C 
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are sold as separate items and were origi- 
nally marketed by Tandy. The OS-9 Level II 
assembler is included with Tandy's Devel- 
opment System (Cat. No. 26-3032). These 
products may still be available through 
Tandy ' s Express Order system (1-800-32 1 - 
3133). Alternatively, CoCoPRO! often 
carries these products. 




THE RAINBOW welcomes letters to the 
editor. Mail should be addressed to: Let- 
ters to Rainbow, The Falsofl Building, 
9509 U.S. Hwy 42, P.O. Box 385, Pros- 
pect. KY 40059. Letters should include 
the writer's full name and address. Letters 
may be edited for clarity or to conserve 
space. 

Letters to the editor may also be sent to 
us through our Delphi CoCo SiG. From 
the CoCo SIG> prompt, enter RA I to get to 
the Rainbow Magazine Services area of 
the SIG. At the RAINBOW> prompt, 
enter LET to reach the LETTERS> prompt, 
then select Letters for Publication. Be 
sure to include your complete name and 
address. 
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Preventing 
Namespace Pollution 

Almost everything in a computer pro- 
gram has a name; variables, functions and 
macros all need to have names associated 
with them. As you begin to tackle larger 
programs, it becomes increasingly difficult 
to keep track of what each name means and 
which names have already been used. On 
the average, my assembly-language pro- 
grams use about one name for every two to 
four lines of source code, so a 5,000-line 
assembly-language program will have 
around two thousand names in it. The local 
scoping rules in C help some, but organiz- 
ing names is still a serious problem. And 
basic, with it's two-character limit on vari- 
able names, makes it very difficult to keep 
track of names. 

The collection of names or labels used in 
a program is sometimes called the name- 
space, and I find the term namespace pollu- 
tion a particularly vivid metaphor for a 
problem that commonly arises in managing 
larger programs. What we'd like to con- 
sider are some techniques and approaches 
thai can be used to reduce the pollution 
levels. 

Names Have Structure 

Just as larger programs should be broken 
into smaller pieces in order to make them 
more manageable, the same applies to 
names. By imposing some structured ap- 
proach on the way we create names, we can 
make our lives much simpler. Not only 
does it become easier to create new names, 
the names are also be more meaningful. 

Many programmers break names into 
three parts: a prefix, a root and a suffix. 
Usually the prefix and suffix identify what 
part of the program the name belongs to 
(such as f for a library function) or what 
kind of object it is (e.g., I for an integer). 
The root is created by the programmer to 
describe the use or purpose of the object. 
For temporary variables, the root is some- 
times empty or i s simply a digit (e.g., i 1 and 
i2 for temporary integer variables). How 
the three parts of a structured name are 
separated is largely a matter of personal 
style. Sometimes case can be used, as in 
i S i z e for an integer variable that represents 
;i si/e. Sometimes a punctuation mark serves 
the purpose, as in I^SIZE. 

In developing an approach to naming, 
you need to consider what specific prefixes 
and suffixes will mean. Also think about 
which root names you'll use most often 
(e.g.. Max, Min, Size, Limit, Count, etc.), 
and how these will be combined to form 
complete names. 

Naming by Location 

One way to use this idea is to mark each 
name by the part of the program it belongs 
to. 1 have found this especially useful for 
generating labels in assembly language 
source code. Within a routine named mul 16. 
I might use the labels mul 16a. mul 16b and 
so on. Here, the name of the subroutine 
becomes the prefix. Length considerations 



sometimes make it impossible to use the 
full name, but the general idea can still be 
applied. In C, this is unnecessary for local 
variables but can be useful for structures 
and unions. Adding the structure or union 
name as a prefix or suffix can help you 
avoid a problem common with older com- 
pilers as well as provide an easy double- 
check on your own code. 

Some programmers actually reuse large 
amounts of code from previous projects. In 
these cases, it can become necessary to use 
prefixes to identify not only the subroutine 
or component but also the program. This 
helps you avoid conflicts when combining 
pieces from several different programs. 

To prevent names from becoming ex- 
cessively long, it's a good idea to use just 
one or two letters for each prefix. For ex- 
ample, a subroutine from the print portion 
of a database package might be named 
dpr Format, where the d indicates that this is 
pari of the database program, and the pr 
indicates the function is part of the print 
routines. Extending this convention to file- 
names makes it even easier; the dprFormat 
function might be stored as dprint.c or 
even dpr.c. {Editor's Note: For an ex- 
ample of this approach in action, see the 
source code for Phil Scherer's BBS9 start- 
ing on Page 18 of the October 1992 issue. ] 

In BASIC, this technique is quite com- 
mon. Often, programmers use the same 
first letter to start the names of all variables 
used in a specific subroutine. For example, 
all variables in the Print subroutine may 
start with P. If you need more than 36 
variables, you may use two or more differ 
ent prefix letters. (While only the first two 
characlers are used by the GoCo for name 
differentiation, you can use more than Iwo 
characlers for BASIC variable names.) 

Naming by Type 

Naming by place is frequently used for 
functions and labels, but another technique 
is often more useful for naming variables 
(especially local variables), hi this approach, 
a prefix or suffix is used with the name to 
indicate the type of the variable it specifies. 
This approach is heavily used in FOR- 
TRAN, where variable names beginning 
with the letters 1 through N are assumed to 
represent integers, and other variables are 
assumed to be real valued. BASIC also uses 
this in its convention that variables with 
names ending in a dollar sign are assumed 
to be string variables. Gaining popularity 
among C programmers is a very sophisti- 
cated version of this approach in which a 
coded prefix is used to indicate the type of 
variables. When combined with the idea 
about naming structure elements mentioned 
above, you end up with names such as 
iWidth_rect for a field of struct rect 
which holds the width of the rectangle as an 
integer. Although such names look cum- 
bersome at first, they become quite useful 
as your programs become more complex. 

Some Examples 

Techniques for keeping track of names 
have been in use for a long time, and it's 
worthwhile to consider several before trying 
to develop a style thai suits you. Following 
are some common approaches: 

»*■ OS-9 System Calls — most of the 
names defined by OS-9 begin with a prefix 
consisting of one or two uppercase lellers 
followed by a punctuation mark. Some 
examples include H for function system 
calls. I $ for I/O system calls, SS . for setstat 
codes, and D for system direct-page vari- 
ables. 

«*• Hungarian convention — many C 
programmers have adopted a convention in 
which each variable is prefixed with a type 



code. By using i for integer, 1 for long, etc., 
and augmenting the name with such things 
as p for pointers, a programmer should 
immediately be able to properly reference 
iSize as an integer indicating a size, or 
pi Si ze as a pointer to a long integer indicat- 
ing the correct size. (Easy question: What's 
the type of *ppiSize?) By augmenting 
names with short prefixes for constructed 
types, this method makes it easier to create 
new names (a temporary char * mighl be 
called simply pc) and helps to discourage 
certain common programming mistakes 
(such as confusing a pointer-to-long with a 
pointer-to-int). 

"»" C-library conventions — the ANSI 
standard defines some standard methods of 
identifying certain C library functions. 
Unfortunately most of the names in the C 
library were developed by a variety of people 
over a long period of time, so there is no 
comprehensive standard to Ihe approach 
used in creating these names. Among other 
conventions, the ANSI standard dictates 
that programmers should never use names 
beginning with an underscore since those 
are reserved for use by the compiler and 
library. There are also families of functions 
whose names are prefixed with is, to or 
str. 

■3" FORTRAN conventions — as 
mentioned above, there is a long standing 
convention in FORTRAN that variables 
beginning with I, J, K. L, M or N arc integer 
variables. All other variables are real. This 
has been used in naming the standard func- 
tions (e.g., ABS is the real absolute-value 
function; I ABS is the integer version). This 
extends to the identification of double-pre- 
cision functions with a leading D and com- 
plex functions with a leading C. 

«" BASIC conventions — the BASIC 
language has a convention that variable 
names ending with a dollar sign are string 
variables. In BASIC09, this is not enforced 
(any variable can be defined as a string 
variable), but the convention is widely used 
even there. 

Consistency is the Key 

Whatever method of naming you decide 
to use, the most important thing is that you 
use that method consistently throughout a 
program. In Ihe process of working with a 
specific method, you may well find prob- 
lems with that method, but you should 
resist the temptation to change it until you've 
finished writing the program. Using differ- 
ent naming styles within the same program 
inevitably leads to a great deal of confusion 
and frustration. 



Tim Kientzle is currently pursuing a doc- 
torate in mathematics at the University of 
California at Berkeley. He is the author of 
V-Term and has worked with the Color 
Computer since 1982. 




Wilh the CoCo 1 and 2, it is especially 
important to make sure the printer is online 
before sending data to it. Include the fol- 
lowing line in your BASIC programs to de- 
termine whether or not the printer is ready: 

A-(PEEK(65314) AND 1> 

If Ihe value returned in Variable A is 1. the 
printer is not ready. (You can use any 
numeric variable in place of A.) 
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ecently while 
playing Bingo 
with my two 
young 
daughters, I 
had a great 
idea for us- 
ing my Color 
Computer — 
"d write a pro- 
gram to print out 
all the possible Bingo- 
card arrangements. I had never seen a pro- 
gram that docs this, yet it seemed to me it 
should be easy to write one. 

Instead of just charging in and writing 
the program (as I normalh do). I decided (o 
make the task a little more interesting. So I 
dusted off my old college statistics book. 
The first realization to hit me was that it had 
been over 20 years since my last statistics 
class. So I dusted off that part of my brain as 
well, then proceeded to rediscover the 
subject and apply it to the task at hand. 

Each Bingo card has five columns, the 
first of which contains five vertically ar- 
ranged numbers that may range from l to 
1 5. The second column also contains five 
numbers, but these values range from 16 to 
30. The third (middle) column holds only 
four numbers (because of the Free space in 
the middle) in the range 3 1 to 45. Column 4 
contains five numbers that may range from 
46 to 60. and the range for the five numbers 
in the fifth column is 61 to 75. 

The older part of my brain (now more or 
less dust free) told me this arrangement 
sounded a lot like the subject of probability. 
specifically combinations and permuta- 
tions. A quick check in my stals book indi- 
cated that combinations is a technique in 
which you are selecting n different objects 
taken r at a time with no attention given to 
the order of the objects. On the other hand, 
with permutations the order of the objects is 
important. Since the order of the numbers 
in a column is very important in Bingo (two 
cards containing the exact same numbers 
but in a different arrangement will not 
normally produce a "bingo" at the same 
time). I decided permutations was what I 
needed to use. 

The example given in my statistics book 
dealt with determining the number of per- 
mutations of the letters A, R and C, taken 
two at a time. The possible arrangements 
are AB, BA, AC. CA, BC and CB. so the 
numberof possible permutations is six. The 
general equation to figure this out, instead 
of writing down all the possible arrange- 
ments and counting them, is 

nPr = n\l(n-r)l 

Here, nVr does not stand for National 
Public Radio but is an abbreviated way of 
saying the Permutations of n different ob- 
jects taken r at a lime. The exclamation 
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point (!) means factorial. A factorial works 
sort of like raising a number to power. 
Simply subtract a value of one from the 
number, then multiply this by the orginal 
number. Now subtract one again and multi- 
ply the result by the previous product. This 
process continues until you reach zero. 
Following arc a few easy examples: 

l! = l 

2! = 2 x l = 2 

3! =3x2x1 =6 

4! =4x3x2x1= 24 

Let's try the equation and see if it really 
works for the example of the letters A, B 
and C above. There are three letters taken 
two at a time. Therefore 

3P2 = 3!/(3-2)! 
=31/(1)! 
= 3!/l! 
= 6/1=6 

It works ! Now back to the Bingo card. In 
terms of permutations. Column I contains 
1 5 numbers taken five at a time. Let's use 
the equation again: 

1 5P5 =151/(15-5)! 
= 151/10! 

= 11.sx14x13xI2x11x10x9xSx7x6x5x4x3x2xI> 
(I0x9x8x7x6x5x4x3x2x I ) 

We could multiply all these numbers 
and divide, or we could let the CoCo do it. 
But there is a way to make the job easier — 
we can cancel like terms in the numerator 
and denominator. After this, the equation 
reduces to 

15P5=15!/10! 

= 15 x I4x 13x 12x 11 

= 360,360 

It is interesting that both halves of this 
six-digit number are the same; but. of 
somewhat greater importance, it tells us 
there are more than a third of a million 
possible permutations of the first column 
alone! Since the second, fourth and fifth 
columns are also "15 numbers taken 5 at a 
time," each has 360,360 permutations as 
well. 

Because of the Free space, 
the third column is 15 numbers 
taken four at a time. Therefore 



15P4= 157(15-4)1 
= 151/11! 

= 15x 14x 13x 12 
= 32,760 

The total number of pos- 
sible arrangements can now be 
calculated by multiplying the 
number of permutations for 
each column, or: 



(360,360)" x 32,760 

which my CoCo tells me is 5.52446474 x 
10 26 in scientific notation. To get a feel for 
how big this number is, imagine it as a 5 
followed by 26 zeroes. 

Well, now I know why 1 haven't seen a 
program to print out all the possible Bingo 
cards. I find it absolutely mind-boggling 
that such a simple game as Bingo could 
produce an almost unbelievable numberof 
unique game cards. 

Now what do I do with my great idea? I 
know . . . I'll write an innocent-looking 
article on Bingo, sneaking in a statistics 
lesson on permutations. But what about the 
program I wanted to write in the first place? 
Obviously my original idea won't work — 
even at one printed card per second it would 
take billions and billions of years! So I'll 
settle for something a little less ambitious. 

The relatively short program accompa- 
nying this article prints single pages with 
four Bingo cards each. Since the program 
uses no special printer codes, it should work 
with any printer. Each page can be played 
as a set of four cards, or you can split the 
page by cutting on the *'s to make four 
single cards or two sets of two cards. The 
number areas on each card are the perfect 
size for using pennies or buttons as mark- 
ers. Each printed card should be different, 
within the random-number capabilities of 
the CoCo. 

The information provided in this article 
won't improve your odds of winning games 
at your local Bingo hall . Nor will it help you 
get rich playing the lottery. But the program 
is useful, and you might just have learned a 
little something along the way. 



Steve Ostrom has a bachelor' s degree in 
mathematics and a master's degree in food 
science. He has been a CoCo owner and 
subscriber to THE RAINBOW since the begin- 
ning .and he enjoys programming the CoCo 
in DAS/C and assembly language. He can he 
contacted at 126 J 2 Cedar Luke Rd.. Min- 
netonka.MN 55305-3944.1612)546-7608. 
Please include an SASE when requesting a 
reply. 
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'BINGO CARDS 
'BY STEVE OSTROM 
'COPYRIGHT (C) 1992 

Y FALSOFT, INC. 
'RAINBOW MAGAZINE 
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2 

3 

4 'B 

5 

50 ' 

60 CLEAR1000 

70 DFMS$(8).M(4.4).Lt(4.4).F 

4).MS(4) 

80 CLS:PRINTe8."3ING0 CARD MAKER 

":PR[NT:?RINT"MAKE SURE YOUR PRI 

NTER PRINTHEADIS PROPERLY SET AT 

THE I0P OF IHE PAGE. 1 HIS PR 
OGRAM USES ALL56 STANDARD LINES 
ON AN 8 1/2X11SHEET OF PAPER. SO 

PROPER ^APCR/PRINTIIEAD ALFGNMCN 
T IS CRITICAL." 

90 PRINTS480. "PRESS <EN1ER> TO P 
RINT..."::INPUTAt 
100 CLS: 3 RINTS235. "WORKING..." 
110 X-RND(-TIMER) 
120 S${1)-" 3B3B IIIII N 



N GGG 000 






130 S$(2)-" 8 B 




NN 


N G 






140 S$i3)=" 3BBB 




N N 


N G GGG 






150 StM)-" 3 B 




N N 


N G G 






160 Si;5)-"( 1-15) 


flh 


33) (31-4 


5) (46-60) (51-75) 



















S$!7)=". 



190 GOSUB240 

200 PRINT#-2.STRING$(79.'-") 

210 PRINT//-2.STRINGK39." ••);"*" 

220 GOSUB240 

230 GOTO80 

240 GOSUB630 

250 L$(2.2)="FREE":R$(2.2)-"FREE 



260 PRINT#-2.SK1):" 
270 PRINT#-2.SK2);" 
280 PRINI#-2.S$(3);" 
290 PRINT#-2.Sf(4);" 
300 PRINT#-2.S$(1);" 
310 PRINT// 2.SK5);" 
320 FORY-0TO4 
330 PRINT#-2.SS<5):" 
340 PRINT#-2.St(7):" 
350 PRINT#-2,5$(7):" 
360 FORX-0TO4 
370 M$(X)-.$(X.Y) 
380 NEXTX 
390 GOSUB500 
400 PRINT#-2.S$(0>;" 
410 FORX-0TO4 
420 M$(X)-R$(X.Y) 
430 NEXTX 
440 GOSUB500 
450 PR1NT#2,S$(0) 
460 PR:NT#-2.St(7) : " 
470 HEXTY 

480 PR:NT#-2.S$(6):" 
490 RE~URN 
500 S$(0)=". "+M»(0) 
)+". . "+M$(2)1-". . 
"+MS( 4 )+■".": RETURN 
510 FORY-0TO4 
520 FORX-0TO4 
530 N(X.Y>-0:NEXTX.Y 
540 FORY-0TO4 
550 FORX-0TO4 
560 N(X.Y)-15*X+RND(15> 
5/0 1FY=0IHEN610 
580 FORZ=0TOY-1 
590 :FN(X.Y)-N!X.Z> THE 
600 NCXTZ:tFrL-lTHEN560 
610 NEXTX. Y 
620 RETURN 
630 GOSIIR510 
640 FORY=0TO4 
650 FORX=0TO4 
660 :FN(X,YX10THENL$(X 
N(X,Y))+" "ELSEL$!X.Y) 
S(N(X.Y)).2.1)+" "+MID 
.Y)).3.1)+" " 
670 NEXTX, Y 
680 GOSUB510 
690 FORY-0TO4 
700 FORX=0TO4 
710 :FN(X.YX10THENR$(X 
N(X.Y))+" "ELSERSIX.Y) 
S(N(X,Y)).2,1)+" "tMIDt 
,Y>),3,1>+" " 
720 NEXTX. Y 
730 RETURN 



SSU) 
SK2) 
S$(3) 
SJ(4) 
SSU) 
SJ(5) 

SK6) 
St(7) 
SK7) 



St(7) 
St(5) 



. "+M$(1 
$(3)+". . 



,Y)=STR$( 
-M1D$(STR 
(STS$(N(X 



,Y)=STR$( 
-MI3$(STR 
(STR$(N(X 



fr*\ 



BINGO 



I 7 23 41 

II 30 33 


52 72 


48 68 
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Energy is everything: your home world depends on it However, 
someone or something is slowly siphoning it away. As your world's 
champion, you must climb into the experimental Power Tank to 
challenge this nemesis and his minions. Your Key lies with the ability 
lo teleport solid mass. Use this to manipulate and explore the endless 
stronghold ot the enemy, and to exploit the free-tloatlng DUPES 
(Dense Units ot photon Energy) to destroy the menacing Plasma 
Droids. Be cautious, though; those DUPES can be deadly, too! 
Photon, a fantastic new arcade game for your Coco3. contains spec- 
tacular 320x200 resolution, 16 color graphics, ultra-smooth 60 Hz 
animation, and loads ot real-time music and sound effects. It will 
send your mind racing over endless possibilities, requiring quick 
decisions and reactions, Quite simply. Photon is incredibly addictive; 
it will deliver hours ot excitement, Will you become your world's 
greatest hero, or just another 
energy slave? Req. 128K CoCo 3 
and disk drive. 



GrafExpress 2.0 is a complete graphics and music programming en- 
vironment From the beginner lo the accomplished prolessi 
can use GtafExpress to create lightning last arcade games graphic 
applications and utilities, and windowing multimedia aemonstra- 
tions! The GrafExpiess packaye includes two incredible 
GrafExpress 16 works on all monitor types and offers support in 12 
graphic resolutions (from 128x192 to 320x225) GrafExpress 256 ot- 
ters 6 resoutions (from 128x192 to 160x225 on a composite monitor! 
in an astounding 256 colors 1 Ever see a CoCo do that betore? Both 
systems include standard graphics commands (CIRCLE. I 
that blow away the competition. For example, the BOX command 
peaks oui at over 2 MegaPixels/secona: that's 300 times taster than 
BASIC! 255 separate sprites ol up to 100x100 pixels each are sup- 
ported with window clipping and high-res pixel level collision check- 
ing The 8-octave/4-voice music synthesizer has independent 
envelope, waveform, and volume controls, a 7 + KHz sampling rate, 
and much more. Other features include text/graphics mixing, dif- 
ferent font sizes, fast window copying and scrolling, picture 
save/load, easy Implementation from both BASIC and assembly 
language, multiple screen animation, and support for 128K/512K. 
double speed, and the high-res joystick interface. The package also 
contains support programs that are worth the purchase price of 
GrafExpress alone! These include an introductory demo, a picture 
editor, a waveform edito', and an art program that supports 256 col- 
ors! GralExpress also comes with a 50 page manual that fully ex- 
plains all ol its incredible features. If you do any graphics program- 
ming or simply want to see what 
your little CoCo is capable of. 
GrafExpress is a must! Req 128K 
CoCo 3 and disk drive. 
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The world is in unrest. Power-hungry villains and evil warlords are 
readying their forces. It falls to you to lead your people against these 
armies, and onlv your best strategic plans can save the day Fight 
the good fight in any era or locale. Play a simple game of capture the 
flag armed with water balloons, or climb into the cockpit ot a 100 foot 
high armored warrier. Explore the deepest dungeons, defend your 
galaxy, or create your own scenarios with this incredible war game 
construction set/simulator. Your imagination Is your only limit You 
will deploy your forces with total control over hostile terrain while you 
scroll a graphic bird's-eye window over an immense world War 
Monger has terrific 320x200 resolution, 16 color graphics and 
eludes a tile editor to create or edit your own. Play against the com- 
puter, battle with another player, or simply watch the computer plot 
against itself. The enemy is everywhere. Are you ready to take on I 
challenge as the War Monger? Req. 
128K CoCo 3 and disk drive. ■« H f T 




An immensely popular 128K CoCo 3 arcade/adven- 
ture. Over 500 screens of fast fantasy action and 
puzzle solving. Great graphics and sound effects 
$34.95 Hmfoook only $4.95. 



A VAlU* BtE 



A 512K two player futuristic combat arcade game. 
Full screen 320x225 hardware scrolling and 
smooth animation. Back-grnund music score and 
sound effects! 512K Coco3 only 34.95. 
Shipoing soon! 



THE game of '91! Ultra-fast space ac 
with hardware scrolling on a 128K CoCo 3 Wild 
sound effects and over 30 MegaBytes of amazing 
graphics! 34,95. 



Lightning fast arcade game for the I2SH 
Terrific 320x225 graphics back-ground music 
score and sound effects, and out-ot-sigh: 
play. $29.95. 
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Warrior King, 

CoCo 3 


$29.95 


In Quest of the Star Lord 

CoCo 3 
Hint Sheet 


$34.95 
$ 3.95 


Hall of the King 1, 2 or 3 

CoCo 1 - 3 


$29.95 ea. 


Hall of the King Trilogy 


$74 95 


White Fire of Eternity 

CoCo 1 - 3 


$19.95 


Dragon Blade 

CoCol -3 


$19.95 


Champion 

CoCol -3 


$19.95 


Paladin's Legacy 

CoCo 1 - 3 


$24.95 






Everyone loves this 512K arcade game 3 disks 
packed with spectacular graphics and eerie 
background digital sound etiects 51 2K CoCo 3 on- 
ly. $34.95. 



The best selling 128K CoCo 3 martial arts arcade 
came. Now available in both RS-DOS and OS-9 ver- 
sions Play the incredible combat experience 
you've been missing under the operating system of 
your choice! $29.95. 



A polyphonic digital sound sequencing system tor 
your 128K/512K CoCo 3 with a user-frier: 
and-ciick graphic editor. Create music SCO 
your own sounds or from the many we provid 
$34.95. 

Sample instrument disks: 6 sides of sampled 
sounds/instruments. Only $12.95 each or $29.95 
for all three. 



Visa. Masletcard. Check. Money Order, and COO 
(USA only, pleasel accepted. Ail foreign orders 
must be sent in US currencv Money Orcers Include 
$2.50 lor shipping in USA and Canada. $5.00 
Foresign. $3 OC extra for COD orders PA residents 
add b% sales tax. Dealer inquiries welcome. 
Authors, were looking lor new software 1 





urtpoq 



P.O. Box 766 • Manassas, VA 221 1 1 
703/330-8989 



September 1992 



Feature Program 

thnee 
of cho 








by torn Beshaua 



So what is all this "Chaos" stuff anyway? 
I've seen Mountains and a Ball with twigs 
growing from it, but 1 don't get it. Rather, I 
didn't get it until my curiosity got the best of 
me, and I took a trip to the local library. What 
the people at the library told me is that Chaos 
is based on mathematical formulas. And they 
weren't kidding! 



I still don't fully understand, but I did 
find an interesting example of Chaotic struc- 
ture even I could comprehend. Get a pencil 
and paper, a ruler and a game die. Draw the 
three points of a triangle and label them as 
follows: 



Point 



Label 



Top 


A(l,2) 


Rt. Bottom 


B(3,4) 


Li. Bottom 


C(5,6) 



Notice that the numbers used here corre- 
spond to the numbers on the six faces of the 
die. Pick a random point on the paper and 
label it R. Now roll the die and, whatever 
number is displayed, determine which of 
the three points it is associated with ( A, B or 
C). Measure the distance between Point R 
and whichever point the die indicates, di- 
vide this distance in half, and place a dot at 
thai point. This random point, halfway 
between R and the other point, becomes the 
new Point R. Now repeat the procedure. 

If you keep repeating this procedure for, 
say, 8 to 12 hours, you'll see the finished 
product. I don't imagine many of you will 
want to actually do this, but if you at least do 
several repetitions over a period of a few 
minutes, you should get an idea of how this 
works. To make shorter work of the whole 
concept, I wrote a BASIC program to handle 
the task for me. 

Triangle relies on the fact that the CoCo 
has the ability to display many different 
dots and to address those dots individually. 
It also has the ability to add and subtract 
numbers very quickly. To use the program, 
enter it and save it to tape or disk, then run 
it. You'll see an onscreen display of that 
horrendous task I asked you to perform 
only a few minutes go. 

Now let's use the CoCo manual to under- 
stand how the program works. First find the 
64-by-32-pi xel worksheet in the back of the 
Coco manual. Although Triangle doesn't 
use this exact screen (the program is de- 
signed to use the CoCo 3's HSCREEN2), the 
larger worksheet is much easier to read. 
Now, place a point at 30 dots across and 2 
dots down, and label that point A(1.2). 
Place another dot at ( 1 0,20) and label that 
point B(3,4). Place ihe third dot at (50,20). 
labeling it C(5.6). Lei's place the random 
dot Rat (20,10). 



The two parts of each location above 
represent the x and v coordinates, respec- 
tively, of our four points. For Triangle's 
purposes, the top point would be AX=30, 
AY=2, and the random point would be 
RX=20, RY=I0. After the program places 
these points (again, we are performing 
manually exactly what the program does), 
it rolls an imaginary die. We'll say that the 
die roll is a 5, which indicates Point C. 

To place the new random point R, the 
program determines if the current RX is 
gTeaterthan or less than CX. In this case, 20 
is less than 50, so RX is less than CX. The 
new value for RX is determined as follows: 

RX NEW = ((CX-RX OLD )/2) + RX ()|D 
= ((50-20)/2)+20 
= (3()/2)+20 

= 35 

Since the current value of R Y is also less 
than C Y, the same formula is used to deter- 
mine the new value of RY. The result is 15, 
so we place a dot at location (35,15) and 
Label it R. Now the CoCo rolls the die again, 
and the process continues. 

The equation to use when RX is greater 
than the other point is as follows: 



CoCo 3 



RX. 



= RX OLD -((RX om -CX)/2) 



where CX might be replaced with AX or 
BX. depending on Ihe die roll. Should one 
of these equations produce a fractional result 
(say, 32.5), the CoCo's I NT function is used 
to truncate that decimal value. 

Earlier I said that 1 still don't understand 
Chaos. But this little exercise has at least 
helped me understand some of the method- 
ology behind it. I hope you find the subject 
of Chaos more enjoyable, too. 



Tom Beshara is a self-taught CoCo 
programmer. He has written inventory, 
sales and tracking programs for the 
children's clothing consignment store 
his wife Lorie owns, and is now work- 
ing on a program to produce estimates 
at his auto body shop. Torn can be 
reached at 2633 Manassas Wax, Colo- 
rado Springs. CO 80922. (719) 471- 
8888. Please include an SASE when 
requesting a reply. 



The Listing: triangle 

1 'TRIANGLE 

2 "BY TOM BESHARA 

3 'COPYRIGHT (C) 1992 

4 'FALS0FT. INC. 

5 'RAINBOW MAGAZINE 
10 IIC0L0R 0.14 

20 HSCREEN2 

30 F=20:P=176:R=300:T-176:L- 

I-12'THF X.Y COORDINATES OF 

. C 

40 HSET(F.P)'«POINT A 

50 HSET(R.T)'-POINT B 

60 HSET(L.I)'-POINT C 

70 X-RNC(300) 

8e Y-RNCU76) 

90 HSET(X.Y)'- FIRST RANDOM 

T R 

100 Q-RN0(6)'=THE DICE 

110 IF 0-10R 0=2 THEN G0T016 

0INT A 

120 IF Q-30R 0-4 THEN G0T017 

0INT B 

130 IF Q-50R Q-6 THEN G0T018 

OINT C 



140 GOTO100 

150 '*** CONVERTS THE X. Y COORD 

INATES OF A. B. C TO A COMMON VA 

RIABLE 

160 D-F:S-P:GOTO190 

170 D-R:S-T:GOTO190 

180 D-L:S-I 

190 IFX<0 THEN XX-D-X:GO T O210 

200 IFX>D THEN XX-X-D:GO"O230 

210 XX-XX/2 

220 X-X+XX:GOIO2b0 

230 XX=XX/2 

240 X-D+XX 

250 X-INT(X) 

260 IFY<S THEN YY-S-Y :GOTO280 

270 IFY>S THEN YY-Y- S:GOTO300 

280 YY-YY/2 

290 Y-Y+YY:GOTO320 

300 YY-YY/2 

310 V-S+YY 

320 Y-INT(Y) 

330 HSET(X.Y)'- NEW MEASURING P0 

INT R 

340 GOTO100 
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Feature Program 

GET ON TARGET! 

by Steve Puis 

Have you got an itchy trigger finger? How 
about some target practice? If your answer 
to these questions is Yes, Phaser Range is 
here to help. Phaser Range is a short pro- 

gam that presents a moving target on the 
oCo's screen. Using the joystick, you 
must aim at the target and pull the trigger 
(push the firebutton). 

When you first run Phaser Range, you 
are asked to select a playing level from 1 to 
20. Level 1 is very easy (perfect for those 
little CoCo nuts), and Level 20 is a real 
challenge. After you select the desired level, 
the game starts and a small circle, the target, 
starts moving around the screen. Use a 
joystick plugged into the right joystick port 
to aim the crosshairs (the little thing that 
looks like a plus sign). When you are on or 
near the target, push the firebutton and a 
circle forms on the screen. If the target is 
within this circle, you score a hit. 

You have about a minute to hit a target; 
if you fail to hit it, the game restarts. After 
you've hit ten targets, the average number 
of shots it took you to hit each target is 
displayed. At this point, simply press the 
fire button to play another round. Press 
BREAK to exit. 

Phaser Range runs on any CoCo with at 
least 16K and Extended basic. The high- 
speed poke is used in Line 1 to increase the 
playing speed. If you are using a CoCo 3, 
change this poke to POKE 65497.0. Also, 
since the computer is not slowed down 
when you press BREAK to exit the game, 
make sure you enter the normal -speed poke 
before performing any disk or printer I/O. 
CoCo 1 and 2 users should enter POKE 
65494.0. and CoCo 3 users should enter 
POKE 65496.0. 

Phaser Range is a safe way to develop 
and enhance hand/eye coordination. Best 
of all, it works year round and on rainy 
days, loo. 



Steven Puis is a high-school junior at 
Lyons Central School. Since his introduc- 
tion to the CoCo six years ago. he has 
written a wide range of software for the 
computer. He aspires to a career in pro- 
gramming or a related profession. Steven 
can be contacted at 605 Pleasant Valley 
Rd., Lyons, NY 14489. Please include an 
SASE when requesting a reply. 
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The Listing: Phaser 

1 'PHASER RANGE 

2 'BY STEVEI PULS 

3 'COPYRIGHT (C> 1992 

4 'BY FAIS0FT. INC. 

5 'RAINBOW MAGAZINE 
10 POKE65495.0 

20 L=3000:RN-1 

33 A$="NU5ND5U5N*5" 

40 CLS0:INPJT "LEVEL (1 EASY - 2 

HARD)";lV:IF LV<1 OR LV>20 THE 

N 40 ELSE R-21-LV 

50 PMODE4:SCREEN1.1:PCLS0 

60 HT-0:S-0 

70 PC.S0: : OR RD-1 T3 10 

80 TM-RND(530)+L 



90 PlAY"T255I 255V3103CDEFGAB04CD 

EFG8":H-0:V=0:X=160:Y-96:H1-0:V1 

-0:V3-0:H3=0 

100 H1-RND(320):V1-RND(190):H2=R 

ND(50):V2-RND(100):T-RND(50)+50: 

CIRCLE(H,V>,3.1 

110 IF Hl+H2>329 OR Vl+V2>189 TH 

EN A-2 ELSE A-l 

120 H-H1:V-V1 

130 TIMER-0 

140 Z1-RND(15):72-RND(15):PSET(H 

.V.1):X-JOYSTK(0)*4:Y-JOYSTK<1)* 

3 

150 ON A GOTO 250.270 

163 IF H<0 OR H>255 OR V<0 OR V> 

193 THEN GOTO90 

173 CIRCLE(H.V).3,1 

180 1FPEEK(65280)-254ORPEEK(6528 

0)-126THENS-S+l:H3-160:V3-192:IIS 

-X-160:VS-192-Y:Sl-HS/20:S2-VS/2 

0:FORT-1TO10:PSET(H3.V3.1):PSET( 

H3.V3.2):PSET(H3.V3.3):PSET(H3.V 

3.0):H3-H3+S1:V3-V3-S2:NEXTT:PLA 

Y"V31L255T25505AC":CIRCLE(X.Y).R 

.1:PCLS:GOTO220 

190 DRAW"BM=X;.-Y;C1"+A$:CIRCLE( 

H.V).3,0:URAW"BM-X; ,-Y:C0"+AJ 

200 PSET(X.Y.1):PSET(X.Y.0) 

210 IF TIMER>TM THENPLAY "03T258 

AGFEDCCO2BAGFEDCCC":GOTO340 ELSE 

GOTO 140 
220 D1-H-X:D2-V-Y:IF (D1*D1)+(D2 
*02K(R*R) THEN PLAVT25503DCDC 
DCDC0C0CDECED":HT-HT+l:G0TO 240 
ELSE A-RND(2):H-HfRND(5)*RN0(2)- 
1:V-V+RND<5)*RND(2>-1 
230 GOTO 140 

240 10R CD-I TO 20 STEP 5:P0KE&H 
FF22.RND(32)+223:CIRCLE(II.V>.CD. 
1.. 3: PLAY "T25L803C":CIRCLE(H,V) 
,CD.0..3:POKE8,HFF22,25b:NEXT CD: 
GOTO290 
250 PSET(H.V.0):H-H+Z1:V-V+Z2:IF 

H>H1+H2 OR V>VUV2 THEN A-2: GOT 
0160 

260 GOTO 160 
2/0 PSt!(H.V.0):H-H-Zl:V-V-Z2:IF 

H<H1-H2 OR V<V1-V2 THEK A-1:G0T 
160 

280 GOTO 160 
290 NEXT RO 
300 SCREEN 0.2:CLS0 
310 PI AY"V31T2612C3CV21I5CV10L16 
CCV5L64CCCV2L255CCCCC" : PRINT "YO 
UR AVERAGE SHOTS PER HIT WAS "+ 
S1R$(S/10)+" FOR R0UNC":RN 
320 PRINT ©256. "PRESS fire BUTTO 
N FOR NEXT ROUND"; 
330 IF PEEK(65280)<>254 AND PEEK 
(65280)0126 THEN 320 
340 CLS3:PRINT@32. "PRESS FIRE BU 
TT0N TO RESTART" 

350 IF PEEK(65280)<>264 AND PEEK 
(65280)0126 THEN 350 
360 RN-RN+1:R-R-(LV/4):IF R<1 TH 
EN R-l _. 

370 GOTO 50 /?\V 
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EDDIE KUNS 



Delphi Joins Internet 



Delphi is now connected to Internet, a 
computer network between hundreds of 
thousands of computers worldwide. You 
can now send and receive electronic mail 
with people all around the world, including 
colleges and universities. CompuServe. 
America Online. MCI Mail and various 
businesses. You can also communicate with 



people connected to Usenet and FIDO net- 
works. If you want to use Internet, how- 
ever, you must first register. 

You can register for Internet mail by 
entering GO USING INTERNET from any 
Delphi prompt. This takes you to a menu 
where you have three options: You can exit 
if you change your mind, you can cancel if 
you have already registered and you later 
change your mind, or you can register. 
When you enter REGISTER, you first see 
several pages of information about the net- 



Advanced Forum Details 



In the last two issues, I've explained in 
increasing detail the many features of Del- 
phi's Forum areas. We'll continue this with 
explanations of the remaining commands. 

If you read a Forum message and don't 
want to decide immediately whether or not 
to reply, use the TAG command to tag the 
message for viewing later. For example, 
suppose another user asks a question you 
can answer, but you don't know if some- 
body else has already replied. Simply enter 
TAG after reading the message, then con- 
tinue reading Forum messages. Before you 
exit Forum, enter READ TAG to read the 
messages you tagged (when you exit Fo- 
rum, the tags are removed from any mes- 
sages you have tagged). Then you can decide 
whether or not to reply. It is polite to make 
sure how others have replied; otherwise 
several people may offer the same reply to 
a simple question. Note that once you read 
a tagged message, it loses its tag unless you 
tag it again. 

If you want to keep a permanent copy of 
a Forum message, there are several options 
available to you. The quickest method is to 
capture the text to disk, assuming your 
terminal program supports that feature. 
Another option is the FILE command; if 
you have just read a Forum message, 
entering F I IE SAVETH 1 S . TX I creates a file 
named SAVETHIS.TXT containing the Fo- 
rum message in your Workspace. You can 
also add modifiers to the FILE command. 
For example, entering FILE SIG.TXT THREAD 
57826 tells Delphi to save Message 57826 
and all subsequent messages in its thread to 
a file in your Workspace named SIG.TXT. 
When you use this modifier, Delphi first 
asks if you are sure you want to save a range 
of messages into the file. There are many 
possible modifiers; to see the full list, enter 
FI LE ? at the Forum> prompt. 

Modifiers are also supported by other 
Forum commands. Two such commands 
are DIRECTORY (or DIR) and READ. In fact, 
these commands use most of the modifiers 
that work with the F I LE command. Two of 
the more commonly used modifiers are 
FROM usemame and TO username. You can 
specify both in a single command, but only 
one FROM and one TO at a time. If you want 
to search a specific range of Forum mes- 
sages, specify this by entering low- 
number -.high-number. You can use either a 
colon (:) or a hyphen (-) to separate the two 
numbers. You can also specify open-ended 
ranges such as 12543- and -54312, which 
mean what you would expect — from 
Message 12543 to the last message, and 
from the first (or current) message to Mes- 
sage 54312, respectively. 

Thus, if you want to search for all the 
Forum messages between 10000 and 1 1000 
that were sent by or to Kevin Darling (ROAR- 
LING), you could enter: 

dir 10000:11000 from kdarling or 
to kdarling 



If the resulting listing contains more 
lines than your current screen-length set- 
ting (/LENGTH). Delphi prompts you afteT 
each page. To get around this, you can 
specify NS (or NONSTOP) on the command 
line. Notice that I used OR in the above 
command line. If you do not specify OR or 
AND between consecutive modifiers, Delphi 
assumes you mean AND. 

Another way to narrow a search is by 
using the date modifier. You can specify all 
messages BEFORE and/or SINCE specific dates 
to search a span of time rather than a range 
of message numbers. The date needs to be 
in a day -month-year format. For example, 
12-jan-1992 specifies January 12, 1992. 
As another example, to read all messages 
posted on March 28, 1992, without pausing 
between them, you could enter 



read since 28-mar-1992 
e 29-mar-1992 ns 



)efor 



You already know about READ NEW and 
READ WAITING. Remembering that READ 
and DIR share the same options, you can 
also type DIR WA I T I NG to sec which unread 
message are addressed to you. Depending 
on how many messages have been addressed 
to you in Forum, this command may lake a 
while. 

You can also search through Forum 
messages by subject using the SUBJECT 
modifier. For example: 

dir 57500-58000 subject "vm & o 
sk" 

gives you a directory listing of all messages 
between 57500 and 58000 that have VM & 
0SK as their subject. 

As with the FILE command, you can 
specify THREAD to follow a specific thread 
with the READ and D I R commands (but you 
may specify only a single message num 
ber). You can specify FT (short for follow 
thread) with READ NEW to see all new mes- 
sages, following threads as they are en^ 
countered. Many people read messages by 
opening a capture buffer and entering READ 
NEW NS FT to read all new messages non- 
stop, following threads. Then they read the 
captured buffer offline. 

Remember the IGNORE commai.d 1 
mentioned last month? This command can 
be used to ignore specific messages and 
threads, and it supports the same set of 
modifiers as FILE, READ and DIR. To see a 
fu 1 1 list of the modifiers supported by any o f 
these commands, enter the command name 
followed by ?. 



Uploads at a Glance 

In the OS9 Online Applications database. 
Homer Meyer (MEYEOOl ) released another 
set of utilities for creating and deleting 
directories. John Semler (semler) released 
a new version of N/ST for both OS-9/6809 
and OSK. (Both versions are in the Appli- 
cations database.) This program tells your 
modem to call the National Institute of 
Standards and Technology (NIST) tele- 
phone time service, and it sets your system 
time to the correct time. 

Hugo Bueno (MRGOOD) uploaded a 
description ofUUCP map entries. Both this 
description and the USA UUCP site list 
contributed by Rick Adams (rickadams) 
are useful to people who want to connect 
their CoCos to Usenet. John Farrar (TRix) 
released the latest version of TRXmon, a 
program that functions like TSMon. TRXmon 
has many features, including utilities to 
handle password files with encrypted pass- 
words. 

In the Programmers Den database, David 
Graham (nimitz) and Greg Law (gregl) 
uploaded OSK binary and source, respec- 
tively, for GNU Indent, a free C source- 
code formatter. In the OSK Applications 
database, Mike Sweet (DODGECOLT) re- 
leased Version 0.70 of DOC. This is a demo 
version of his simple OSK word processor/ 
editor. Glen Hathaway (COMPER) contrib- 
uted a screen saver and a file-size finder, 
both ported from the CoCo. Scott Kasten 
(SKASTEN) released Sphere, a simple mo- 
lecular modeling program. 

In the CoCo SIG General Information 
database, Alfredo T. Santas (ALFRADIO) 
uploaded a list of the Tandy catalog num- 
bers for all the items Tandy sold in support 
of the CoCo. Robert Newhart (BNEWHART) 
released in the Games database a simula- 
tion of the 1991 Iditarod race (from An- 
chorage to Nome, Alaska). 

In the Music & Sound database. Rich- 
ard McNabb (rickmac) uploaded 0RCMMA, 
a public domain Orchestra-90-typc music 
editor and compiler. Terry M. Blackwell 
(TMB) contributed TJUKEB0X, a program 
that sends Musica II files to your TV speaker, 
stereo cartridge, Orchestra-90 Pak or MIDI 
cartridge. 

Beraie Patton (bernibp) announced the 
release of a patch to EDTASM that adds 
support for the new 6309 opcodes and many 
other new features. 



work. You'll probably want to capture this 
information in a disk file for later reference. 
In any case, it is important that you read this 
information carefully. Finally, you are asked 
if you want to register. Make sure you 
understand the terms, limits and costs be- 
fore answering Yes. 

If you register to use Internet mail, you 
will be billed S3 every month for Internet 
mail access. With this access comes a limit 
of 10 megabytes of Internet mail each 
month; this would be a tremendous amount 
of mail, so it is unlikely that you'll exceed 
this limit. Still, be careful. Also remember 
that mail is stored in your Delphi Work- 
space, and you pay for all disk space used 
beyond the first 50 blocks (25K). 

On Internet are many computer mailing 
lists that function similiarly to Forums on 
Delphi. There are mailing lists for every 
topic you can imagine — from fractals to 
computers to political discussions. If you 
join a mailing list, remember that you should 
read and delete mail frequently to avoid 
paying for more disk usage than you are 
willing. Some mailing lists have a large 
amount of mail daily; some have only a few 
messages per week. 

One very nice feature of Internet is the 
ability to connect to Delphi from any other 
computer on the system, although you 
cannot connect to other computers from 
Delphi. On most Internet-connected com- 
puters, you can log onto Delphi by entering 

TELNET DELPHI.COM 

You should then see Delphi's USERNAME: 
prompt. Telnet carries no telecommunica- 
tions surcharge, so you can connect to Delphi 
any time of the day using Telnet and pay 
only for connect time. Note that I am not 
referring to Telenet (now named Sprint- 
Net) which you reach via telephone; Telnet 
is a feature of Internet and is available only 
on computers directly connected to Internet. 
Most colleges have computers that are so 
connected. Ask your local system adminis- 
trators if you are unsure. 

Not all of Delphi 's features arc available 
when you connect via Telnet. For example, 
you cannot download any files. On the 
other hand, Telnet connections are almost 
always faster than 2400-bps modem con- 
nections. 

If you want more information, call Del- 
phi customer service at 1-800-695-4005 
(61 7-491-3393 for people outside the United 
States). 



Eddie Kims is pursuing a doctorate in 
physics at Rutgers University. He lives in 
Aurora, Illinois, and works as a program- 
mer and researcher at Fermilab. Eddie is 
the database manager of OS9 Online and 
can be reached online as EDDIEKUNS. 
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OS-9 SIG 



General Information 

DATADE.X ANNOUNCEMENT 
EDELMAR Ed Gresick 

HD6309 INFO 
JOHNBAER John Baer 
0S-9 MAJ1C MAGAZINE 

INIST Michael Oral lam 
PNW C0CDI EST REPUKI 
SALZARD Rodger Alexander 

Applications (6809) 

INVENTORY PLUS VERSION 2.1 
MOHK ! Jim Veslal & Tim Mohr 



CR0N 9: TASK SCHEDJALER 

WOAY Jim Martin 

PATCH FOR TSFMT 

BROADAXE Paul Brodnax 

MD AND RD FOR OS-9 

MEYEOOl Homer Meyer 

FUN LIB: AD-LIB STORY GENERATOR 

MOHRT Jim Veslal & Tim Mohr 

rONTASIZE: FONT DESIGNER 

JAMIEC Jamie Cho 

CCCLK: COCO CORNER CLOCK 

SAM35 Steve Mylonas 

NIST VI. 1: TIME SERVICE DIALER 

SEMLER John Semler 
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Telecom (6809) 

UUCP MAP DESCRIPTION 
MRGOOD Huso Bucno 

UUCP SITE LIST FOR U.S. 
RICKADAMS Rick Adams 
TRXMON DEMO RELEASE 
TRIX John Farrar 

System Modules (6809) 

J&M PARALLEL P0R1 UK1VLK 
WOAY Jim Martin 

INTFIX: INTERUPT HARDWARE HACK 
DEAN HOLDER Dean Holder 

Music & Sound 

ST:TNG MONOLOGUE 
DEAN HOLDER Dean Holder 
PORKY PIG SOUND FILE 
DEANHOLDER Dean Holder 
CORDS. L2H (STEREO) 
JOHNBAER John Bacr 
SHORT CIRCUIT SAMPLES (MAC) 
MODEL299 Mark Sleiner 

ST:TNG MINI THEME 
CDETJBRIJFJN Chris Deierlein 

Programmers Den 

HERSHEY FONT DATABASE 

DRDUDE Andy DcPue 

GNU OSK INDENT 

NIM1TZ David Graham 

GNU INDENT 

GREGL Greg Law 

OSK Applications 

DOC VERSION 0.70 
DODGECOLT Mike Sweet 
DATADEX DEMO VERSION 
F.DELMAR Ed Gresick 

UTIL1: TWO SIMPLE UTILITIES 
COMPER Glen Hathaway 

SPHERE MODELER 
SKASTEN ScotlKaslen 

LHA V2.01 FOR OSK 
MIKEHAALAND Mike Haaland 

OSK Telecom 

XYDOWN FOR OSK 
TTMKIENTZLE Tim Kienlzle 

OSK System Modules 

UPGRADED MM/1 DRIVERS 
TIMKIENT2LE Tim Kienlzle 



Tutorials & Education 

TFACHC: C TUTORIAL 
BOBKEMPER Robert Kemper 



CoCo SIG 



(ieneral Information 

TANDY SUPPORT FOR COCO 
ALFRADIO Alfredo T. Santos 

CoCo J Graphics 

MAC TO CM3 VERSION 2.1 
RICKMAC Richard McNabb 

TORI AMOS 4096 
DEANHOLDER Dean Holder 
FRANKENSTEIN DS69 
DEANHOLDER Dean Holder 
REN & STIMPY 
DEANHOLDER Dean Holder 
TWO VIRGINS 
DEANHOLDER Dean Holder 

Source for 6809 Assemblers 

HD63B09E INFORMATION 
HYPERTECH Chet Simpson 

Hardware Hacking 

HARDWARE INTERRUPT FIX 
DEANHOLDER Dean Holder 

Games 

IDITAROD.ARC 

BNEWHART Robert Newhart 

THE DOCTOR 

JOCOCO JoNeph Worthington 

SPIDER HYPE GAME 

JOCOCO Joseph Worthington 

Classic Graphics 

DIGI'D PIC FOR C0C03/CL0NES 
STEVEPDX Steve Ricketts 

Music & Sound 

0RCHMA MUSIC EDITOR 
RICKMAC Richard McNabb 

SHAREWARE MUSICA PROGRAM 
RICKMAC Richard McNabb 

TJUKEB0X.ARC #2 
TMB Terry M. Blackwell 

Product Reviews & Announcement 

EDTASM6309 

11 1 KM IP BcmicPatlon 
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GRANITE COMPUTER SYSTEMS 

ZOOM BRAND MODEMS NEW LOWER PRICES! 

14,400 BPS V.32bis/V.42/V.42bis modems. MNP1-5+LAPM. 

Error Correction and Data Compression (much higher throughput - as much as 57,600 ops). 
Data only: External $269 Internal $249 ($9 S&H*) 

With S/R FAX: 299 279 

9,600 BPS V.32/V.427V.42bis modems. MNP1-5+LAPM. 
Error Correction and Data Compression (much higher throughput - as much as 38,400 bps). 
Data only: External $239 Internal $219 ($9 S&H*) 

With S/R FAX: 259 239 

9,600 BPS Send/Receive FAX Modems. 
Send and Receive text/graphics files fronVto your computer from/to Fax machines anywhere 
in the world. Full 2400 bps data mode. 

FAX & Data: External $119 Internal $109 ($6 S&H*) 

With MNP1-5/LAPM (hardware): 139 129 

2,400 BPS Data Modems. 

Data only: External $75 Internal $59 ($6 S&H*) 

With MNP1-5/LAPM (software): 85 69 

These are high quality modems made by Zoom Telephonies in the USA. Seven year 
factory warranty. Fully Hayes compatible. Terminal and FAX software is included with FAX 
modems. Terminal and Windows (PC) software available. MAC software also available. 
Cables available. * S&H Canada: V.32A/.32bis modems $13.00. Other modems $9.00. 

GCS FILE TRANSFER UTILITIES - Version 3.0 

GCS File Transfer Utilities provide a simple and quick method to transfer text/binary files 
from/to a variety of floppy disk formats. 

Commands: PC.RS.FLEX disks: Dir, Dump, Read, Write 
PC Disks: Rename, Delete, Format 

Handles most 5.25 and 3.5 formats. Any level sub-directories (PC). Binary files. Use pipes for multiple 
file transfers. Multi-Vue version can be used under Multi-Vue or as stand alone Shell commands. 



Requires: OS-9 L2 for CoCo 3. L1 for CoCo 1 or 2: two drives (one can be hard/ramdisk, one floppy 
40 track DD DS): Multi-Vue for Multi-Vue version; SDISK3 for CoCo 3. SDISK for CoCo 1 or 2. 

OSK version $99.95 

Mulli-Vue version $54.95 Standard version $44.95 

Version 3.0 updates (provide disk number) $25.00(OSK) $15.00 

D P Johnson Software SDISK or SDISK3 $29.95 L1+L2 Utilities $75.00 
Shipping and handling - any software S2.50 USA $3.00 Canada 

Orders must be prepaid or COD, COD is $3.50 additional. VISA, MC, DISCOVER 

571 Center Road, Hillsborough, NH 03244 USA 
(603) 464 - 3850 



Product Review 



Life and Death 



The game of Life has been very popular 
with computer programmers and users since 
the beginning of the computer revolution. 
Perhaps the reason for this popularity is that 
Life demonstrates the computer's ability to 
maintain consistent random-pattern gen- 
eration; besides, the changing screen looks 
pretty. Stilt, in the early days, all the game 
of Life could do was develop endless pat- 
terns of activity that were interesting to 
watch and difficult to understand. Life and 
Death from BDS Software, however, is 
truly a game. 

In Life and Death, two players (or one 
player and the computer) compete in a life- 
and-dealh struggle. The Life and Death 
"world" is a 40-by-4l grid of squares, and 
the object of the game is to control more of 
the grid ' s 1 640 squares than your opponent . 
To do this requires strategy and tactics — 
Life and Death is not an arcade or adventure 
game in any sense. There are no fancy 
graphics or sound effects. 

One player's markers are red, and the 
other player plays blue. During a player's 
turn, he uses the arrow keys to move an 
onscreen cursor to the location where he 
wants to place a marker. I had a lough lime 
determining where the tiny cursor was lo- 
cated: on an RGB monitor, the playing 
screen is a light green grid on a yellow 
background, and the cursor is a faint dash 



— very hard for these old eyes to follow. 

When each player has placed his mark- 
ers, death and reproduction (a new genera- 
tion) begin to occur, as with the original 
game of Life. This is the part you can't 
control and is the real mystery in the game 
of Life and Death. Believe me, the rules by 
which death and reproduction occur in Life 
and Death get pretty complex. 1 found it 
helpful to watch the demonstration game 
included on the disk. This proved to be an 
excellent way to understand how the game 
is played. 

Since there is no limit to the possibilities. 
Life and Death doesn't name a winner. 
Rather, players must predetermine what 
"winning" is. Perhaps you'll play the game 
a specific number of turns, or you could 
impose a simple time limit. Another way is 
to specify a winning number of markers on 
the board (Life and Death displays this 
information for each player). 

Life and Death is designed to run on any 
CoCo system with a disk drive. It works 
with televisions as well as composite and 
RGB monitors. The game is very easy to 
play, yet sometimes difficult to understand. 
On the other hand, so is life. (BDS Software, 
P.O. Box 4X5, Glenview. IL 60025-0485. 
708-998-1656; $10 plus $3 SIH.) 

— Robert Gra\ 



3 The C Compiler for the CoCo has finally arrived. 



CoCo-C 



CoCo-C is a complete RSDOS based C development package for the Color Computer not 
requiring the OS-9 Operating System. CoCo-C consists of five main programs: a Text 
Ediior. a C Compiler, an Assembler, and a Library Linker which are all controlled by the 
CoCo-C Command Coordinator. 



Text Editor 

A full featured screen oriented line editor for the CoCo3 developed by Bob van der 
Poel. Powerful editing and cursor commands with auto-indent and user defined 
macros make this a great editor for writing C or assembly language programs. A less 
sophisticated version for the CoCo 2 is also available. 

C Compiler 

The CoCo-C Compiler is a full featured K8R style integer compiler specifically 
designed for RSDOS based systems. It has assembly language output, position 
independent code and can output ROM-able code if desired. Added features allow you 
to mix C, assembly language and BASIC commands within your program! 

Assembler 



This symbolic assembler is capable of assembling files as large as available disk 
space. I: supports a Motorola style syntax and outputs standard binary files ready for 
LOADM and EXEC. Options include list file output and gene-ation of symbol table file. 

Library/Linker 

The Library Linker is a utility which links the CoCo-C's 90+ function library with your 
compiled binary file, creating a stand alone executable ML file. 



Command Coordinator 

The Command Coordinator is CoCo-C's main program. Its user friendly menu driven 
screen smoothly switches back and forth between the Editor, Compiler, Assembler and 
Linker. 

The CoCo-C Compiler package includes BOTH CoCo 2 and CoCo 3 versions 
of ALL the programs listed above plus MORE! Compatible w/B&B RGBDOS 

Never before has there been an offer like this for the Color Computer ! 

Requires 64K COCO 2 or 128K COCO 3 Send check or money order to: 

introductory Offer Infinitum Technology 

Only $59.95 P.O. Box 356 

^ Saddle River, N.J. 07458 

Plus $4.00 shipping & handling 914-356-7688 
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lthough Grid War plays 
pretty much like the board 
game Battleship, it does 
have one great advantage: 
it keeps the players honest. As with Battle- 
ship, each player hides four naval vessels 
on a grid and takes pot shots at the other 
player's ships. The first player to sink all of 
the other's ships wins. But with the board 
game, it is possible for clever players (a 
light term for cheaters) to move their ships, 
making it nearly impossible for the other 
player to win. Since Grid War is played on 
the Color Computer, it is impossible to 
move the ships during the battle. 

Grid War i s a two-player game designed 
for the CoCo 3; the game requires two 
joysticks. To play the game, first enter the 
listing and save the program to tape or disk. 
The game uses the high-speed poke (POKE 
65497 .0), so be sure the computer is set to 
low speed (POKE 65496 , 0) before you save 
it. With a copy of the game tucked safely 
away, enter RUN. 

After the title screen appears, the two 
players are prompted to enter their names. 
The next screen displays the playing grid, 
along with the four ships and the number of 
grid spaces each requires. The current ship 
to be positioned is indicated in the middle at 
the bottom of the screen. While his oppo- 
nem is not watching, each player uses the 
joystick to place his ships on the grid. To do 
this, move the block cursor to the desired 
location and press the fire button. You are 
asked whether the ship should be oriented 
vertically or horizontally. Press V or H 
accordingly . If the ship's placement creates 
no conflicts with other ships or the grid's 
borders, the ship is drawn and the next 
vessel to be placed appears. 

Once all the ships are in place, you are 
asked if the positioning is correct. If you 
want to change where a ship is located, now 
is the time to do it. 

After both players have placed their 
ships, another screen appears showing both 
players' grids side by side. Each player in 
turn uses his joystick to select a square on 
his opponent's grid. When he presses the 
fire button, the screen displays either a Hit 
or a Miss, and the other player gets a turn. 
Play continues until all the ships on one grid 
have been located and sunk. At that point, 
the ships on both grids are shown and the 
the game is over. 



Mike Switzer is an electrical engineer 
who has worked with the CoCo and other 
computers for 10 years. His hobbies in- 
clude drag racing, model railroading and 
watching the Buffalo Bills. 
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The Listing: gridwar 



GRID WAR 

BY MIKE SWITZER AND 
CECELIA FORLINI 
COPYRIGHT (C) 1992 
BY FALSOFT. INC. 
RAINBOW MAGAZINE 



7 ON BRK GOTO 840:POKE65497 .0 

8 ■ 

9 'SET VARIABLES 

10 HSCREEN 2:PALETTE 2.15:PALETT 
E 4,5G:PALETTE 7.52 

15 DIM GC(2.10.10).GS$(2.10.10) 

20 HBUFF 1.152:HBUFF 2.152 

25 SS(1)-"BL5U4ER14FRFRFRFD2GLGL 

GLGL14HU4":NSSC)-"CRUISER" 

30 SS(2)-"BL5UEUERER23FRFRFRFD2G 

LGLGLGL23HLHUHU":NS$(2)-"DESTR0Y 

ER" 

35 SK3)-"BL5UERERERER32FRFRFRFD 

2GLGLGLGL32HLHLHLHU":NS$(3)-"BAT 

TLESHIP" 

40 S$(4)-"BL5U2ER12E2R32D2R10FD6 

GL56HU4":NS$(4)-"CARRIER" 

45 St(5)-"U3Rl0FRFRFGLGlGL10U3" 

50 S$(6)-"UEER17FRFRFGLGLGL17HHU 

55 S$(7)-"ERERERZ2FRFRFGLGLGL22H 

LHLH" 

60 S$(8)-"ER9EER22D2R5FD3L40U3" 

98 ' 

99 'DRAW TITLE PAGE 

100 DL-106:GOSUB1000 

105 HGET<160.60) <172.72>.Z:H0RA 

W"BM166.66NElNFlNGlHl":HGETtl50. 

60)-(172. 721.1 

110 H-5:V-3:GOSUB1100:FOR TD-1 T 

300:NEXT:H-l:V-4:GOSUBlZ00:H-0 
:GOSUB1100:FOR T D-1 TO 500:NEXT: 
FOR H-2 TO 4:G0SUB 1200:NEXT H 
115 HC0L0R 1.2:HDRAW"S2BM47.13R2 
2F8D8L8U4H4L14G4D32F4R14E4U4L8U8 
R16D16G8L22H8U40E8" 

120 HDRAW"BM45.52R30F8D16G8L14r2 
4L8H24024L8U568F8R18F408G4L18U16 

125 HDRAW8M49.86R24D8L8O40R8D8L 

24U8R8U40L8U8" 

130 HDRAWBM45.120R30-8D40G8L30U 

56BF8R18F4D32G4L18U40" 

135 HDRAW8M256.32R8U36E12F12U36 

R8056L8U12H12G12D12L8U56" 

140 HDRAWBM264.70R8F16D40L8U24L 

24024 L8U40E16BD8BR4F12D4L24U4E 12 

145 HDRAW8M256.108R32F8D16G8L15 

F24L8H24D24L8U56BF8R20F4D8G4L20U 

16":HDRAW"S4" 

150 HPRINTI8. 22). "WRITTEN BY MIK 

E SWITZER":FOR T-l TO 5000:NEXT 

T:G0SUB 1400 

198 ' 

199 'ENTER PLAYERS NAMES 

200 HC0L0R8.2:F0R P - 1 TO 2:HPR 

1 NT (2, 22). "PLAYER #":HPRINT( 10.2 
2).STRJ(P):HPRINT(12.22).""S NAM 
E>":S0UND 100.5 

205 HT-20:VT-22:GOSUB 1300:P$(P) 
-Tt:G0SUB 1400:NEXT P:P-1 

298 • 

299 'ENTER COORDINATES 

300 GOSJB1000: H-28 : V-51 : Y-4 : GDSU 
B 320:HPRINT(6.6)."A":HPRINT(3.3 
>,NSJ(4):HPRINT<2.9)."(5 GRIDS)" 
305 H-248:Y-3:G0SUB 320:HPRINT(3 
3,6)."B":HPRINT(29.8).NS$(3):HPR 
INT(29.9)."(4 GRIDS)" 

310 H-46:V-107:Y-1:GOSUB 320:HPR 

INT<6.13)."C":HPRINT(3.15).NS$<1 

):HPRINT(2.16)."C2 GRIDS)" 

315 H-256:Y-2:G0SUB 320:HPRINT(3 

3.13)."D":HPRINT(29.15).NS$(2):H 

PRINT(29.16)."(3 GRIDS)":G0T0 32 

5 

320 HDRAW"BM"+STR$(H)+"."+STR$(V 

)---SS(Y):HPAINT(H+2.V). 4.8: RETURN 

325 L-LEN(PJ(P)):HPRINT(20-(L/2) 

.1).P$(P):Y-1 

330 HPRINT(2. 22). "COORDINATES F0 

R":HPRINT(18.22).NS$(Y):SOUND100 

.5 

335 IF P-1THENJ-0 ELSE J-2 

340 GO5UB1500:GOSU81400 

345 HPRINT(2. 22). "DIRECTION <H 

R V>?":SOUND100,5 

350 HT-22 : VT-22 : GOSUB1500 : I FL$-" 

H"THEND$(P.Y)-"0" ELSE DJ(P.Y)-" 

1" 

355 HS(P.Y)-H:VS(P.Y)-V:DS$(P.Y) 

-D$(P.Y):SV-Y 

398 ' 

399 'CHECK IF SHIPS FIT 

400 IF D$(P,Y)-"1" THEN 425 
405 IF H+Y>9 THEN 445 

410 FOR CF-H TO H+Y:IF GCIP.CF.V 

)O0 THEN 445 

415 NEXT CF 

420 GOTO 455 

425 IF V+Y>9 THEN 445 

430 FOR CF-V TO V+Y:IF GCCP.H.CF 

)<>0 THEN 445 

435 NEXT CF 

440 GOTO 465 

445 GOSUB 1900 



450 GOTO 330 

455 HDRAW"A"+D$(P.Y)+"BM"+STR$(l 

H*12) + 106)+"."+STRK<V*12)+30)+S 

$(Y) 

460 GOSUB 1700 

465 GOSUB1400:IF E-l THEN 470 EL 

SE Y-Y+l: IF Y<>5 THEN 330 

470 E-0:HPRINT(2.22)."IS THIS PA 

TTERN OK <Y/N>?":S0UND 100.5 

475 HT-28:GOSUB1500:IFL$-"N" THE 

N 500 

480 IF P<>2 THEN P-2:HDRAW"A0":G 

OTO300 

485 GOSUB1800:P-1:GOTO600 

498 • 

499 'REPLACE SHIP 

500 GOSUB1400:HPRINT( 0.22). "CHAN 
GE WHICH SHIP <A>.<8>.<C>. OR <D 
>?" 

505 HT-39:G0SUB 1630 

510 IF L$-"C" THEN Y-l ELSE IF L 

$-"D" THEN Y-2 ELSE IF L$-"B" TH 

EN Y-3 ELSE Y-4 

516 HC0L0R2.2:01(P.Y)-0St(P.Y):H 

-HS<P.Y):V-VS(P.Y):SV-0 

520 HDRAW"A"+D$(P,Y)t"BM"tSTR$(( 

H*12)+105)+"."+STR$<(V*12)+30)+S 

t(Y) 

525 HC0L0R8.2:G0SUB 1700:GOSUB 1 

400:E-1:GOTO330 

59B ' 

599 'FIRE SHOT AT GRID 

600 3OSU81400:SOUND 100.5:HPRINT 
(2.22).P$(P):L=LEN(P$(P))+1:HPRI 
NT! (L+2). 22). "SELECT GRID" 

605 IF P-l THEN G-2:DL-176: J-0 E 

LSE G-l: DL-36 :J-2 

610 GOSUB 1500 

615 IF GS»(P.H.V)-"M" OR GS$(P.H 

.V)-"H" THEN GOSUB 1900:GOTO 600 

620 IF GC(G.H.V)-0 THEN GOSUB 11 

00:GSKP.H.V)-"M":GOTO705 

625 G0SU8 1200:GS$(P.H.V)-"H":K( 

P.GC(G.H,V))=K(P.GC(G.H.V))+1 

630 IF GC(G.H.V)-1 AND KCP.D-Z 

THEN 700 

635 IF GC(G.H.V)=2 AND K(P,2)-3 

THEN 700 

640 IF GC(G.H.V)-3 AND K(P.3)-4 

THEN 700 

645 IF GC(G.H.V)-4 AND K(P.4)-5 

THEN 700 

650 GOTO 705 

698 • 

699 'DID SHOI SINK SHIP? 

700 H(P)=H(P)+1:GOSUB2000 

705 FOR TD-1 TO 1000: NEXT TD:IF 
H(P)-4 THEN 715 ELSC IT P-l THE 
N P-2 ELSE P-l 
710 GOTO 600 

715 GOSUB 1400:HCOLOR 8.2:HPRINT 
(2. 21). "YOU HAVE SUNK ALL 0F":HP 
RINT( 23.21 ).P$(G):L-LEN(P$(G)):H 
PRINT(23+L.21). M, S SHIPS":F0R TD 
-1 TO 1000:NEXT TD:G0T0 800 

798 ' 

799 'END OF GAME 

800 FOR P-l TO 2 

805 IF P-l THEN DL-36 ELSE DL-17 

6 

810 FOR Y-l TO 4 

815 HC0L0R 1.2 

820 HDRAW"A"+OS$(P.Y)+"BM"+STR$( 

(HS(P.Y)*12)+DL)+"."+STRJ((VS(P. 

Y)*12)+30)+S»(Y) 

825 NEXT Y.P 

830 HPRINT(2.23)."THI5 GAME IS 

VER. PRESS ANY KEY..." 

835 YJ-INKEY$:IF YS-"" THEN 835 

840 CLS:P0KE 65496. 0:END 

998 ' 

999 'DRAW GRID 

1000 HCLS2:HC0L0R8.2 

1005 FOR V-DL-6 TO DL+114 STEP 1 
2:HLINE(V.24)-(V.144).PSET:NEXT 
1010 FOR H-24 TO 144 STEP 12:HLI 
NE( DL-6.H)- (DL+114. HJ.PSET: NEXT: 
RETURN 

1098 ' 

1099 'MISS ROUTINE 

1100 FOR R-3 TO 6 STEP 3:HCIRCLE 
(H»12+DL.V*12+30).R.8:NEXT R:PM- 
31:G0SUB1215 

1105 RETURN 

1198 ' 

1199 'HIT ROUTINE 

1200 HH-H*1Z+DL:VH-V*12+30:HCIRC 
LE(HH.VH).2.4:HPAINT(HH.VH>.4.4: 
PM-1:G0SUB1215 

1205 HCIRCLE(HH.VH).2.1:IICIRCLE( 

HH.VH).4.1:HPAINT(HH.VH-2).1.1:G 

0SUB1215 

1210 HCIRCLE(HH.VH).4.7:HCIRCLE( 

HH . VH ) . 5 . 7 : HPAI NT( HH . VH -4 ) . 7 . 7 : P 

M-31 

1215 PLAY"01L255V31":F0R M-l TO 

PM:PLAY"N10N3N6N4N2N6V-":NEXT M: 



RETURN 

1298 ' 

1299 'ENTER TEXT ROUTINE 

1300 T$-"" 

1305 H-INKEYJ:IF LJ-"" THEN 130 

5 

1310 IF L$=CHRJ(8) THEN L$-RIGHT 

$(Tt.l):Ti=IFFTS(T$.IFN(Tt)-l):H 

C0L0R2.2:HPRINT(HT.VT).L$:HC0L0R 

8.2:HT-HT-1:GOTO1305 

1315 IF L$-CHR$(13) THEN RETURN 

1320 T$-T$+L$:HT-HT+1:HPRINT(HT. 

VT).LJ:GOTO1305 

1398 ' 

1399 'ERASE TEXT 

1400 HLINE(0.176;-(319,191).PRES 
ET,BF:RETURN 

1498 ' 

1499 'LOCATES THE CURSOR WITH TH 
E JOYSTICK 

1500 H-DL:V-30 

1505 JS-OOYSTK(0):HH-JOYSTK(J)*1 

.8:VV-J0YSTK(J+1)*1.8 

1510 H-DL+IINT(HH/12J*I2):V=30+( 

INT(VV/12)«12) 

1515 HGET(H-6.V-6)-(H+6.V+6).2 

1520 HPUT(H-6.V-6)-(H+6.V+6),l.A 

ND 

1525 HPUT(H-6.V-6)-(H+6.V+6).2.P 

SET 

1530 IF BUTT0N(J)Ol THEN 1505 

1535 H-(H-DL)/12:V-(V-30)/12:RET 

URN 

1540 L$-INKEY$:IF L$-"" THEN 154 

ELSE HPR1NT(HT.VT).L$:RETURN 

1598 ' 

1599 'INPUT COORDINATES TEXT 

1600 L$-INKEY»:1F L$-"" THEN 160 
ELSE HPRINT(HT.VT).Lt:RETURN 

1698 ' 

1699 'ASSIGN SHIP TO GRID NUMBER 

1700 IF D$(P.Y)-"1" THEN 1715 
1705 GC(P.H.V)-SV:GC(P.H+1,V)-SV 
:IF Y-l THEN RETURN ELSE GCCP.H+ 
2,V)-SV:IF Y-2 THEN RETURN 

1710 GC(P.H+3.V)-SV:IF Y-3 THEN 

RETURN ELSE GC( P.H+4 , V )-SV : RETUR 

N 

1715 GC(P.H,V)-SV:GC(P,H,V+1)-SV 

:IF Y-l THEN RETURN ELSE GC(P.H. 

V+2)-SV:IF Y-2 THEN RETURN 

1720 GC(P.H.V+3)-SV:IF Y-3 THEN 

RETURN ELSE GC(P.H.V+4)-SV:RETUR 

N 

1/98 ' 

1799 'DRAW BOTH GRIDS 

1800 DL-36 :C-4:GOSUB1000:L=LEN(P 
S(1)):IIPRINT(11 (L/Z).1),P$(1):F 
OR X-1T04:0N X GOSUB1805 , 1810 . 18 
15.1820:NEXT X:G0T0 1825 

1805 H-30 : V-l 52 : Y-5 : GOSUB2100 : RE 

TURN 

1810 H=48:V-152:Y-6:GOSUB2100:RE 

TURN 

1815 H=75:V-152:Y=7.GOSUB2100:RE 

TURN 

1820 H-110:V-152:Y-8:GOSUB2100:R 

ETURN 

1825 DL-176:GOSUB1005:L-LEN(PJ(2 

)):HPRINT(28-(L/2).1).P»(2):F0RX 

-1T04:ON X GOSUB1830. 1835 . 1840 . 1 

845:NEXT X:RETURN 

1830 H=170:V=152:Y-S:GOSUB2100:R 

ETURN 

1835 H-188:V-152:Y-6:GOSUB2100:R 

ETURN 

1840 H-215:V-152:Y-7:GOSUB2100:R 

ETURN 

1845 H-250:V-152:Y-8:GOSUB2100:R 

ETURN 

1898 ' 

1899 'TRY AGAIN ROUTINE 

1900 GOSUB 1400:HPRINT(2.22)."TR 
Y AGAIN":S0UN0 200.5:SOUND 100,5 
:F0R TD-1 TO 1000:NEXT TD:G0SUB 
1400:RETLRN 

1998 ' 

1999 "SUNK SHIP ROUTINE 

2000 FOR X-l TO GC(B,H.V):PM-31: 
GOSUB 1215:NEXT X 

2005 GOSUB 1400:HPRINT(10.22),"Y 

0U SUNK THE":HPRINT(23,22),NSt(G 

C(G.H.V)):C-2:0N G GOSUB 2010,20 

15:RETURN 

2010 ON GC(G.H.V) GOSUB 1805,181 

0,1815. 1820: RETURN 

2015 ON GC(G.H.V) GOSUB 1830,183 
5.1840.1845:RETURN 

2098 ' 

2099 'DRAW SHIP AT COORDINATES 

2100 HDRAW"A0BM"+STR$(H)+","+STR 
$(V)+S$(Y):HPAINT(H+2.V),C,8:RET 
URN 
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Figure 1: AlF.flk Contents 



shown in Listing 2 (Flakes) is a replace- 
ment for the Flake_Maker procedure. Flakes 
selects a black background and makes the 
Flake Maker system suitable for use as a 
screen saver. It is designed to be used in 
conjunction with the Fl ake procedure. The 
program in Listing 3 creates an icon file for 
usingFlake Makerw'tih Multi-Vue: the AIF 
for use in this fashion is shown in Figure l . 

Up and Running 

To get started, first create a Type 7 
graphics window by entering the lines 
shown in Figure 2. Alternatively, enter the 
command lines from Figure 2 in a standard 
OS-9 procedure file, then execute that file. 
When executed, these commands define 
Device /wl as a 4-color graphics window 
having a resolution of 640 by 192 pixels. 
The last line starts an OS-9 shell on that 
window. To move to Ihe. window, simply 
press the CLEAR key. 

With the proper window running, start 
BASIC09, requesting an 8K workspace (enter 
basi c09 #8k). Now tell BASIC09 you want 
to edit the procedure Fl ake_Maker bv typing 
e Fl a ke^ laker and pressing ENTER. 

In the listing for Flake_Maker, you'll 
notice each line begins with a four-digit 
hexadecimal number and several spaces. 
These numbers are used by BASIC09 for 
debugging, and they show the number of 
bytes between the beginning of the proce- 
dure and the beginning of each line. Do not 
enter these numbers or the leading spaces 
when entering a BAS1C09 procedure. 

To enter each line, first press the space 
bar (which tells the editor you are inserting 
a line), then type the text of the line itself! 
pressing ENTER when you reach the end. 
When you have entered the last line of 
Fl a ke_Maker, enter the letter q on aline by 
itself to quit the editor. This returns you to 
BASIC09's B: prompt. Enter Flake in the 
same manner, checking each line for errors 
as you go along. 

If BASIC09 reports any errors after you 
exit the Edit mode by entering q, you'll 
have to correct the errors by deleting and 
retyping the erroneous line. BASIC09 at- 
tempts to tell you where to find each error 
by reporting the memory offset to the line 
containing the error along with the error 
number. For example, suppose you see the 
following when you exit the editor: 

OOBC ERROR #069 

The first number is the Hex memory offset 
from the beginning of the procedure to the 
line containing the error. The last number is 
the actual error number. Restart the Edit 
mode by entering e followed by a space and 
the name of the procedure you want to 
correct. When in the Edit mode, you can 
enter 1 to list the first line of the procedure. 
Press ENTER to scroll through the proce- 
dure one line at a time. When the numbers 
at the left of the listed line are greater than 
the number shown with the error, you have 
found the line after the one with the error. 
Move back one line by typing a minus sign 
(-) and pressing ENTER. Enter d to delete 
the line, then press the space bar once and 
retype the line correctly. 

Before you run Flake_Maker,saveboth 
procedures to disk by entering: 



iniz wl 

wcreate /wl -s-07 00 00 80 24 03 02 02 

merge /dd/sys/stdfonts>/wl 

shell i-/wl& 

Figure 2: Commands for a Type 7 Window 



save* >Flake_Maker 

This command line saves both procedures 
in a file called Fl ake^Maker in the current 
data directory. Then enter run f 1 ake_maker 
to stan the program. Just answer the ques- 
tion about background color, and Flake 
Maker will go to work drawing random 
snowflakes on the screen. 

Program Options 

Flake Maker is pretty nifty by itself. 
However, you may want to use it as a screen 
saver or from within Multi-Vue. Let's look 
at how you can do this. 

To build Flake Maker as a screen saver, 
first delete all the procedures from the BA- 
SIC09 workspace by entering kill* (but make 
sure you first save them todisk as described 
above!). Now enter Fl akes from Listing 2. 
AsIsaidbefore.Flakesisdesignedtowork 
with Flake and replaces the Flake_Maker 
portion of Listing 1 . To get Fl ake into the 
BASIC09 workspace, enter load 
f 1 a ke_ma ke r to load the saved set of proce- 
dures from disk, then kill the single 
Flake Maker procedure by entering kill 
f 1 ake_ma ker. This command kills only the 
first procedure, leaving Fl ake in memory. 
Save the new procedures together as be- 
fore, entering save* >Flakes. 

To test Flake Maker as a screen saver, 
enter run f 1 akes. Press any key to stop the 
program. 

Now you'll probably want to use your 
new screen saver from the OS- r^mmand 
line rather than having to run B ASIC09 every 
time. To do this, you must pack the proce- 
dures it uses by entering pack*. This tells 
BASIC09 to compile the screen saver and 
save the executable program in your cur- 
rent execution directory. (Never pack a 
procedure before you have saved it to disk. 
Once a procedure is packed, you cannot edit 
it — you'll have to revert to the unpacked 
version to make modifications. 

Now your CoCo can draw snow flakes 
on any graphics window (though Flake 
looks best in a Type 7 window) simply by 
entering f 1 akes at the OS-9 prompt. It is 
important to note, however, that runb, inkey 
and gfx2 must be in memory or in your 
current execution directory. It is a good 
idea to merge all of these, along with 
syscal 1, into one file to conserve system 
memory. To do this, first change the current 
datadirectory to the directory where r un b is 
located (usually /dd /CMOS) by entering end 
/dd / cmds . Then save a copy of the original 
runb file by renaming it as runb.org: 

rename runb runb.org 

Now, put runb, gfx2, inkey and syscal 1 
into one file by entering 

merge runb.org gfx2 inkey syscal 
1 >runb 

Finally, make the new merged r unb execut- 
able by entering a ttr runb e pe. 

If you follow these steps, you'll have a 
copy of the original runb rile for later use. 
as well as a merged copy for running packed 
BASIC09 programs. If you have limited disk 
space, you can delete the original files and 
keep only the new runb file (as long as you 
are working with a copy of the system disks 
and not the originals from Tandy). 

If you use Multi-Vue, it is easy to set up 



Flake Maker so that it executes when you 
click on an icon. Enter Listing 3, then save 
it and run it. This procedure creates an icon 
filein the /dd/CMDS/ ICONS directory. Once 
that icon is created, exit BASIC09 by entering 
bye at the B: prompt. 

Use your favorite text editor or the OS- 
9 bui 1 d command to enter the application- 
information file (AIF) shown in Figure 1, 
then save this file to disk in the data direc- 
tory of your choice. A quirk in Multi-Vue is 
that the system does not recognize a new 
AIF unless the disk is scanned from its root 
directory. You can force a scan by clicking 
on the drive icon at the left side of the 
GShell window, then clicking on each folder 
icon until you get to your new AIF. You 
should see a snowflake icon in the direc- 
tory. If you see the document icon, there is 
something wrong with the icon fi le , the ABr 
or the program file. Check the attributes of 
the program file and the icon file. The 

Eubhc- and owner-execution attributes must 
e set (attr should return -e-rewr). List 
the application-information file and check 
to make sure the lines exactly match those 
in Figure 1 . Don't forget to enter the blank 
lines since these tell GShell to use default 



information when starting the program. 

On a related note, one of the things I like 
most about Multi-Vue is that it does a good 
job of setting up the appropriate window 
types for the programs I use. I've heard 
many users have had trouble getting Multi- 
Vue to work properly. I wouldbe more than 
happy to help anyone who writes to me 
asking for help with Multi-Vue. If I get 
enough response, perhaps I'll work on an 
article that addresses the most common 
problems. 

In the meantime, enjoy the snowflakes. 
Though they won't melt on your tongue, 
they are definitely standard fare for the 
season. 



Bill Budenhoher has been a CoCo user 
since 1981 and has learned to program in 
both BASIC and C. His experience with OS- 
9 has helped him gain the skills necessary to 
support Unix workstation users. He can be 
contacted at 7115 Lanham Ave.. St. Louis. 
MO 63143-2511. Please include an SASE 
when requesting a reply. 
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Listing 1: Flake_Maker.b09 



0029 
003C 



00D4 
PROCEDURE 



008? 
00E1 
03EC 
0113 
011A 
013A 
0141 
0165 
0171 
0196 
019F 
01E0 
01E7 
020F 
0216 
0241 
0248 
02bU 
0274 
02A9 
02B4 
02E5 

02 F0 

03 IB 
0322 
035A 
0361 

flake 
03AO 
03B8 
03E5 
03 EC 
0119 
0440 
0455 
0456 
048A 
048C 
04BU 
04BE 
04D3 
04E9 
04FF 
0528 
052C 
0542 
0558 
055A 
0570 
0586 
0599 
05A0 
05AD 
05BE 
05CC 
05D3 
05DA 
0602 
0611 
36 1Z 
062A 
0641 



Flake_maker 
DIM back:STRING 
DIM dl: INTEGER 
DIM key:STRING 
key:-"" 

RUN gfx2("clear") 
RUN gfx2!"curxy".15.10) 

PRINT "Do you want a (B)lack or (W)hite background?" 
RUN gfx2("curxy".15.11) 
INPUT back 
REPEAT 

RUN flake(back) 

FOR dl :=1 TO 10000 

NEXT dl 

RUN inkey(key) 
UNTIL key<>"" 
RUN gfx2("color".1.0) 
END 

Flake 
(* Copyright 1992 by William G. Budenholzer. All Rights Reserved *) 
(* Draws random snow flakes on graphics screen *) 

(* back sets the background color *) 

PARAM back:STRING 

(* hx and hy are the coords for the hexagons *> 

DIM hx.hy:REAL 

(* hex_sz is the size of the hexagon *) 

DIM hex^SZ:R£AL 

(* hexent counts the hexagons *) 

DIM hexent: INTEGER 

(* splen is the length of a spike *) 

DIM splen(10):REAL 

(* spent counts the nuirber of spikes *) 

DIM spent: INTEGER 

(* nunuspikes is the total number of spikes on one side of arm *) 

DIM nunusp1kes:INTEGER 

(* num_flakes is the number of flakes *) 

DIM num_fl akes: INTEGER 

(* col is the random color of the flakes *) 

DIM col: INTEGER 

(* cnt counts the number of spikes *) 

DIM cnt:lNIEGER 

(* xl and yl are the end points of the current arm *; 

DIM xl,yl:REAL 

<* ex and cy are the center of the whole flake *) 

DIM cx.cy:REAL 

(* angle is the angle of the flake's arm *) 

DIM angle:RFAI 

(* rot_angle 1s the rotation angle of the whole flake *) 

DIM rot_angle:REAL 

(* xscale and yscale correct the length of the arms to make a round 

DIM xscale. yscale: INTEGER 

(* radius is the total radius of the flake *! 

DIM radiuS:REAL 

{* sx and sy are end points for the spikes *) 

DIM sxl(9),syl(9).sx2(9).sy2(9):REAL 

DIM sx3(9). sy3(9):REAL 

(* the circle plot routines won't work ir radians *) 
DEG 

(* if back - "B" if we want a black background *) 
IF back-"b" OR back-"B" THEN 

RUN gfx2("palelte".0.$00) 

RUN gfx2("palette".l.$3F) 

(* otherwise we get a white backaround *) 
ELSE 

RUN gfx2("palette".0.$3F) 

RUN gfx2("palette".l.$09) 
ENDIF 

RUN gfx2("palette".2.$lA) 
RUN gfx2("palette".3.$lB) 
RUN gfx2("color".1.0) 
col:-l 

RUN gfx2("clear") 
RUN gfx2("border".0) 
RUN gfx2("curoff") 
xscale:-2 
yscale:-l 

(* Reseed the random number generator *) 
cnt:-RND(-(VAL(MID$(DATE$.16.2)))) 

(* make 2 to 5 flakes *) 
FOR num flakes:-l TO 2+RND(3) 
radius:-RND(20)+20 
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064F 


col :-col+l 


0AA8 


hy :-cySlN(anglei-rot ang'e>*vhex sz*yscale 












0659 


IF col>3 THEN 


0AC2 


IF anglc<30 THEN 












;:. 65 


col :-l 


0AC ■ 


RUN gfx2("setdptr",FIXlhx).FIX;hy)> 












066C 


ENDIF 


0AE8 


ELSE 












066E 


RUN gfx2!"color".cot> 


0AEC 


RUN gfx2("line".FIX(hx). r i:<(hy)) 












0680 


rot. angle:=RND(33) 


0B02 


ENDIF 












0689 


(* find center of next flake *) 


0B04 


NEXT angle 












06A8 


(* don't let flake go off screen *) 


0B0F 


NEXT hexent 












06CB 


CX:-RND(540) 


0B1A 














06D5 


WHILE CX<100 00 


0B1B 


NEXT num_f'akes 












06E2 


CX:-RND(540) 


0B26 














06CC 


ENDWHILE 


SB;'.' 


RUN gfx2("curon") 












06F0 


cy:-RND(130) 


0B34 


END 












06F9 


WHILE cy<60 DO 
















0706 


cy:-RND(130) 
















070F 
0713 


ENDWHILE 


Listing 2: 


Flakes. b09 












0714 
0726 
073E 
074C 
0777 
0787 
0/rth 
0/90 
07A1 
07B2 
07BD 
07BE 
07D7 
07E8 
081F 


[* build an arm *) 

!* make 5 to 9 spikes *) 

num.spi kes:-RND(5)+4 

;* dlstl sets the spacing for the spikes *> 

distl:-radius/(nuni spikesH) 

dist2:-0 


PROCEOURE 
0000 
000/ 
000E 

001b 

001C 


F'akes 
DIM back:STRING 
DIM dl : INTFSER 

DIM key:STRING 

key:-"" 

RUN gfx2("clear") 












= 0R spcnt:=l TO num_spikes 

spl en { spent ):=RN0( radius/?) 
NEXT spent 


0029 
0031 
0033 
0030 


back:-"B" 

REPEAT 

RUN flake(back) 
FOR dl:-l TO 10000 












-OR angle:-0 TO 300 STEP 60 
FOR spent :-l TO nurtuspikes 

(* d1st2 is the accumulated distance from the center *) 
dist2-dist2+distl 


004E 
0069 
0063 
006E 
0081 


NEXT dl 

RUN inkey(key) 
UNTIL key<>"" 
RUN gfx2("color M .1.0) 
END 












082B 


sxl (spent ):-cx+COS(angle+r-ot_angle+0)*<dist2*xscale) 












084D 


syl( spent) :-ey-SIN(angle+rot_angle+0)*(di st2*yscale> 
















086F 


sx2( spent ):=sxl( spent )+COS(angle+rot_angle+60)*(spl en 
(spent )*xscale) 


Listing 3 


Make Icon. b09 












0897 


sy2( spent) : -syl( spent)- SI Nlangl e+rot_angle+60)*(splen 














08BF 

08E8 

0911 
0912 
091D 
092E 

095A 

0986 
0991 
0992 


(spcnt)*yscale) 
sx3 ( spent ):-sxl(spcnt)+COS(angle>rot_angle+300)*< spier 

(spcnt)'xscale) 
sy3( spent) :-syl( spent) SI Nlangl e+rot_angle+300)*( spier 

(spent )*yscale) 


PROCEOURE 
0000 
0022 
002 F 
003A 


Makelcon 
i* Generates a Multi Vue Icon File 
(* for Flakes 
DIM path.bytrBYTE 
DIM count: INTFfiFR 












NEXT spent 

FOR cnt:-l TO num spikes 

RUN gfx2("line",FIX(sxl(cnt)).FIX(syl(cnt)).FIX(sx2(crt 

)).FIX(sy2(cnt))) 
RUN gfx2("line",FIX(sxl(cnt)).FIX(syI(cnt)).FIX(sx3(crt 
)).FIX(sy3(cnt))) 
NEXT cnt 


0041 
005 F 

00 8 J 

0093 
0098 
00A2 
00AD 
00B3 


PRINT "Cresting Icon. Flake . . ."; 

CREATE //pa th.'Vdd/cmds/i cons/icon. Flake": WRITE 

FOR count :-l TO 144 

READ byt 

PUT tfpath.byt 
NEXT count 
CLOSE #path 
PRINT 












(* draw main arms *) 


00B5 
00DC 
00OE 

1 2 ? 
0166 
01AA 


SHELL "att- /dd/emds/i cons/i con . Fl ake e pe" 

END 

DATA $00. $00. $00. $00. $30. $00. $00. $00. $01. $00. $00 

DATA $00. $00, $00. $00, $41. $34. $00, $00, $01, $04. $11 

DATA $05, $41, $44, $00, $20, $14. $51, $14, $50, $00. $01 

DATA $80, $01. $15. $51. $30. $00. $00, $00. $51. $14. $00 












09A6 
09C0 
09OA 
09FA 
0A02 
0A0D 
0A26 
0A27 
0A51 
0A58 


xl-cx+C0S( angle irot_angle!*(rad1us*xscale) 

yl-cy-SIN(angle+rot_angle)*!radius*yscale) 

RUN gfx2("line".FIX<cx).HX(cy).HX(xl>.FIX(yl)) 

d1st2:-0 

NEXT angle 

RUN gf x2("setdptr" . FI X( ex ) . FIX( ey ) ) 


tm 

$10 

$54 


•4: 

Si! 

see 


$00 

100 

$10 
$15 


$01 

$00 

$55 

5 5: 


$00 

$46 
$00 
$15 


01EE 
0232 


DAI A $50, $00. $00, $00. $2b. $40. $00, $00. $00, $00. $0b 
DATA $51. $15, $50. $00. $30. $00, $51. $14, $00, $00, $00 


•4',: 
$01 


500 

s:v 


100 

$5: 


$00 

$00 


$16 
$00 


(* draw hexagons around middle of fake *) 
FOR hexcnt:=l TO 2+RN0(3) 
hex sz:-RND(radius/3) 


0276 
02BA 
02FE 


DATA $01, $54, $11, $10. $55. $00, $00, $14, $51. $14. $50 
DATA $44, $00, $01, $04, $35. $40, $4!, $00. $00. $00. $1 1 
DATA $41, $04, $00, $00, $30. $00. $3 1, $00. $00. $00. $00 


sec 

• 1 
SKI' 


SC0 

$0 
■00 


$45 

$00 
$00 


$11 
$00 

$0 


$01 

$00 
$00 


0A/b 


FOR angle :-0 TO 360 STEP 60 
















0A3E 


Mx:-cx+COS(diigle+roL_dng1e)*(hex sz*xscale) 














tR\ 






From Video Source 




of insulation. Now strip a very short length . 
of insulation from the inner (positive) lead 
of the cable and solder this lead to one pole 
of the SPST switch. Strip a short length of 
insulation from each end of the standard 
wire and solder one end lo the other pole of 
the switch. 

Bend down I he leads of the IK fixed 
resislor, then slip one lead through Tab I on 
the potentiometer and the other lead through 
Tab 2. (Looking from the back of the poten- 
tiometer, with the tabs pointing up and 
away from you. Tab 1 is on the left and Tab 
2 is in the center.) Bend the leads of the 1 K 
resistor slightly so it does not fall out of the 
holes in the tabs. Solder the negative lead 
(the shielding) on the shielded cable to Ihe 
center tab of the 5K potentiometer, along 
with the one end of the IK resislor. Then 
solder the standard wire coming from the 
switch to Tab # I of the potentiometer, along 
with the other end of the fixed resistor. 
After mounting the potentiometer and 
switch in the project box, all that remains is 
to solder the male RCA phono plug to the 
other end of the shielded cable. 

As a construction note, the level control 
should work fine without the IK fixed 
resistor. However. I added this resislor lo 



reduce the potentiometer' s range to about 
through 850 ohms, which makes it easier to 
manipulate the level at the brighter end. 

Connecting the DS-69 

To connect the level control to the DS- 
69B, first plug the male end of the Y cable 
into the digitizer. Then plug the video source 
into one of the female jacks on the Y cable 
and plug the level control into the other 
female jack. 

The switch allows you to control whether 
or not the video signal being sent to the 
digitizer is affected by the level control. 
When the switch is open, the signal is 
unaffected. When you close the switch, 
however, you gain fine control over the 
brightness of the video signal. 



Steve Ricketts is a mainframe operator 
who recently discovered the beauty ofOS- 
9. He is interested in finding a way to use the 
DS-69R video digitizer under OS-9. Steve 
can be contacted at 39230 Hood St., Sandx. 
OR 97055. Please include an SASE when 
requesting a reply. lie can also be reached 
on Delphi via the username STEVEPDX. 



Figure 3 



Once you have gathered the necessary 
parts, you should decide where you want 
the visible components — the switch, 
dimmer and cable — mounted on the proj- 
ect box. Drill holes of the proper size for 
these parts. Next, strip about two inches 



from one end of the shielded cable and 
about half an inch from the other end, then 
separate the negative shielding and insu- 
lated positive lead. Feed the shielded cable 
into the cable hole in the box. starting with 
the end from which you stripped two inches 



Part 


Description 


Radio Shack # 


Rl 


1000 ohms 


271-023 


R2 


5000 ohm poi 


271-1714 


SW1 


submini SPST switch 


275-645 


PL1 


shielded male RCA pluc 


274-339 


Yl 


shielded Y-adapior 


42-2436 


In addition, you'll need some shielded cable 


(about 


8 to 12 in 


ches) and a short piece of standard 




insulated 


wire (22- or 24-guage is One). 






Figure 2: Level Control Ports List 
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Product Review 

TasCOM: OSK 
Terminal Software 

Vaughn Cato's shareware terminal 
program, OSTerm, has long been a favorite 
among users of OS-9 Level II on the Color 
Computer 3. By taking advantage of the 
similarities between the windowing system 
for Level II and the KWindows system 
provided with the MM/1. Mr. Cato has 
made this popular program available for 
OS-9/68000. Although the name has 
changed to TasCOM, the program is enough 
like its predecessor that fans of OSTerm 
should be able to enjoy this program 
immediately. TasCOM does have its draw- 
backs, but its list of features is sufficiently 
impressive to outweigh the minor problems 
I encountered in the interface and docu- 
mentation. 

TasCOM has several features that make 
it convenient and fairly easy to use. The 
Autodialer function allows you to config- 
ure the program for each system you con- 
tact, and you can rapidly create a list of 
systems to be dialed. This is ideal for people 
who frequent a number of BBSs — Tas- 
COM can be set to dial each system in turn, 
in round-robin fashion, until it finds one it 
can connect to. 

The File-transfer section includes a 
convenient file picker that lets you scroll 
through directories with the arrow keys, 
selecting files to be transferred. You can 
use this to quickly create a list of files to be 
uploaded via Ymodem Batch, or to select a 
directory or specific filename for down- 
loaded files. TasCOM also includes a fairly 
good ANSI terminal emulation that pro- 
duces brightly colored menus when used 



with a local bulletin board. As a final touch, 
TasCOM' s Remote mode allows others to 
dial your system and upload and download 
files. This easy-to-use feature provides a 
simple alternative to setting up the TSMon 
and Login utilities to handle remote logins. 

T tested TasCOM, VI .0. 1 , on a 3-mega- 
byte MM/1 running KWindows Edition 38. 
The installation process was quite simple; 
an i nstall script on the distribution disk 
creates a /DD/TASCOM directory, copies the 
executable file and some shell scripts to / 
OD/CMDS, then copies a customizable 
setpalette script to /DD/TASCOM. With 
only five files, it is quite simple to install the 
system by hand if your configuration is 
different. 

The shell scripts are a nice touch since 
they provide easy customization. The tas 
shell script used to start TasCOM sets the 
default directory to /DD/TASCOM, runs the 
setpal ette script, creates a new window, 
then runs TasCOM in that window. This 
approach makes it relatively easy to cus^ 
tomize the directory, the screen colors, the 
modem port and other parameters simply 
by editing the appropriate script. 

I was a little disappointed that TasCOM 
did not by default use /dd/COM/TASCOK for 
its custom files, following a convention 
used by many OS-9 Level II terminal pro- 
grams. But I found it easy to change this. 
The only problem 1 had installing TasCOM 
was that the files on the disk are readable 
only by the superuser, so I was forced to 
login to my system as root in order to read 
the files. Similarly, the install script did 
not set Public Read and Public Execute 
attributes for the files it installed, so I was 
forced to do this manually. 

You can use ALT keys to control the 
program, allowing you to send any charac- 



ter to the host. However, it did not allow me 
to send a NULL character. Overall, Tas- 
COM is easy to use, although the interface 
is somewhat quirky. I believe this comes 
from a general inattention to minor details. 
For example, pressing ALT-/ brings up a 
fist of the available commands, but you 
cannot select a command directly from that 
list. You must first press a key to get rid of 
the list. Similarly, the Autodialer provides 
no simple short cut for selecting and dialing 
a single system: you have to create a list 
with only one system on it, then dial. It took 
me several minutes of searching to discover 
how to edit the Autologin macros. 

I also found some omissions and prob- 
lems. I could find no way to get TasCOM to 
do end-of- line conversions when down- 
loading or uploading ASCII files. This is a 
common feature of many terminal pro- 
grams and is practically a necessity when 
transferring files between dissimilar sys- 
tems. Also, the fact that TasCOM always 
has its default directory set to /DD/TASCOM 
initially was bothersome when transferring 
files — you have to manually change the 
directory every time you start the program. 
TasCOM' s VT1 00 emulation did not func- 
tion correctly when used with full-screen 
programs on a Unix machine. However, the 
ANSI emulation worked acceptably. 

A number of unexplained things hap- 
pened while 1 was using the program, though 
it is difficult to tell whether they werefauhs 
with TasCOM, the still sometimes errant 
system software, or other programs that 
were running on the system simultaneously. 
Whenever a file transfer terminated, for 
example, garbage appeared on another 
window. This was sufficiently reproduc- 
ible that it seems certain to be a bug in 
TasCOM. 



There isn't much to say about the docu- 
mentation, largely because there isn't much 
documentation. The 10-page manual gives 
little more than a list of the options avail- 
able in each part of the program. There arc 
no descriptions of the terminal emulations, 
particularly in the critical area of which 
keyboard keys correspond to some of the 
extended VT100 keys. There is no table of 
contents, and the crunched layout seems to 
emphasize saving paper over ease of read- 
ing. The fact that the manual instructs the 
user to press keys on the CoCo 3 but not on 
the MM/1 keyboard did not help to make a 
good first impression. 

Overall, I find TasCOM sufficiently easy 
to use. I will probably continue to use it on 
an occasional basis, though I will continue 
to look for a program that does a better job 
of VT100 emulation, provides better sup- 
port for file transfers, and sports a stronger 
interface. People who frequently dial a 
number of bulletin boards will appreciate 
TasCOM'% autodialing capabilities and its 
functional ANSI emulation. People who 
transfer files to and from friends' comput- 
ers will appreciate the Remote mode. If the 
author takes the time to polish the user 
interface and address the numerous minor 
problems, TasCOM could be an excellent 
terminal program useful to a broad audi- 
ence. As is, '.'asCOM is a functional pro- 
gram that is comfortable once you under- 
stand how to use it; and it has enough 
features to be a good "second" terminal 
program tor a variety of users. (CoCoPRO!, 
1334Byr,mAve.,Ypsilanti,MI48198,313- 
481-3283; $39.95.) 

— Tim Kientzle 



Plug 'n' Go for Your CoCo! 



^ Pt'w 




§!e©iip NX-1020 



This CoCo compatible NX-1020 system sets new standards in color 
printer performance... 225 cps, 4 NLQ fonts including Script, plus a 
high speed draft font; but the enhancements don't stop there, Add a 
1 6k buffer, a special quiet mode, top feed, bottom and rear tractor, and 
the list goes on. Seven on-demand colors, 8 color graphic modes, 
-Epson and IBM emulation for maximum software compatibility. 
Virtually everything desired in a printer is here — speed, color and 
versatility at an affordable price with a 2 year warranty. 

Our Plug'n'Go for the Coco system includes: 

• NX-1020 Multi Font Color Printer 

• Blue Streak Ultima 

• Software Support Disk 

• Color Graphics Utilities 



it r i unci 

$ 239 



95 



ll^NX-1001 

This CoCo compatible NX-1001 system is fully featured with 4 NLQ 
plus a draft fonl, 1 character sizes from subscript to quadruple size, 
4k buffer, 180 cps, friction and tractor feed, and much much more. 
Backed by a 2 Year warranty. Epson and IBM emulation modes for 
maximum software compatibility. A performer so versatile you may 
never exhaust it's creative possibilities! 

Our Plug'n'Go for the Coco system includes: 

• NX-1001 Multi Font Printer $10088 

• Blue Streak Ultima 

• Software Support Disk 



$ 188 j 




The Ultimate Serial to 
Parallel Interface! 

The Blue Streak Ultima 

7 Switchable Baud Rates ■ 300 thru 19200! 

• An interface cable that converts the serial output of a CoCo 1 , 2 or 3 
to a standard parallel formal, compatible with mooern parallel printers. 

• Connecting the Ultima isas easy as plugging in the cable ' The four pin 
din plugs into the serial I/O port of your CoCo and the other end, a 36 
pin connector, connects to the parallel port » g%^ 
of the printer ROAJJU 



STAR 24 WIRE PRINTER SYSTEMS ALSO AVAILABLE! 
CoCo compatible • Color and Monochrome • Call for pricing 



The Ultima is powered with the +5V supplied 
by most printers on pin 18. If your printer 
does not have +5V on pin 18 you'll need to 
add the power option when ordering. 



$ 39 ! 

♦ S2 Sapping 

POWERED VERSION 

ADD $6.00 



Order Your System Today... Call (513) 885-5999 



DAYTON ASSOCIATES "£% INC. 

9644 Quailwood Trail • Spring Valley, Ohio 45370 



VISA 




S9 





o Epson Corp IBM is a registered trade mark ot inte'naiiorul Business Macrmes Corp 



Visa & Mastercard Accepted. 

Ohio residents add 0.5% sales tax COD add $4.00 

Snipping cheiges to Canada. PR. Hi. AK. APC. FPO are double Triple charge to all other countries 

Price and Soecittcatlons are subject to change wthout notice 



All Dayton Associate's products have 
a 30 day moneyback guarantee. 
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Dead CoCos and Odd Drives 

^^fc II hen I play Arkanoid, the second 
^^^. player joystick won't work correctly. 
Using a different physical joystick does not 
fix the problem, and both joysticks work 
fine with other games and with R ASIC pro- 
grams. Also, my 5I2K CoCo just died. It 
comes up with a yellow screen with black 
vertical lines. What should I do? How can 
I change the disk drive ribbon connector on 
MARTY GOODMAN my JDOS drive to the disk drive connector 
on my Tandy drive? 

Owen I. Crabtree 
College Place. Washington 



512K On the Blink 
^tk I have a CoCo 3 with a dead 512K 
^^^ Disto memory board (it gives me a 
blank screen). When 1 took it to Radio 
Shack for repair, they stated the problem 
was with the third-party memory board and 
that they could not help me. Now I find that 
Disto'CRC is not available to help me. 
apparently having left the CoCo market. 
What can I do? 

Gil Brown 

San Luis Obispo, California 

A First, remove the 51 2K board and re- 
install the four 4464-1 5 or equivalent 
memory chips that were originally in your 
CoCo 3. Does the computer work? If so, 
you have narrowed the problem down to the 
5 1 2K board. Note that Radio Shack repair 
often won't service a computer with non- 
factory parts installed and may well have 
just returned it without much checking the 
moment they saw that Disto 512K board. 
To properly check a CoCo usually requires 
that you own a second one that is known to 
be good. You really should try testing that 
Disto board in a known-working CoCo 3. 

If the 5I2K board is proven bad, you 
must determine whether the problem is a 
failed memory chip, or a problem with the 
board or its contacts. Suitable memory chips 
(256K-by-l, 120ns or 150ns) are cheap, 
costing a dollar apiece or less, so you might 
want to buy a few of them from a chip 
vendor and start substituting. Perhaps you 
have a bad chip. Other possible problems 
are shorts and/or cold solder joints on the 
512K board. Carefully inspect the board, 
looking for bad solder joints. Try resolder- 
ing every point on the board (sounds tedi- 
ous but actually takes only 5 or 1 minutes 
if you have some skill at fine soldering). 
You should consider swapping the chips 
out of a known-good 512K memory board 
and putting them on your suspect board to 
attempt to differentiate whether the prob- 
lem is the memory chips or the board itself. 
Also, keep in mind that sometimes prob- 
lems arise due to shoving the memory board 
too far into the connectors on the mother- 
board, or from the board shorting out to 
something beside or below it. Check for 
this. 

If the 5 1 2K board tests good in another 
CoCo 3, try replacing the 68B09E chip (this 
requires that you desolder the 68B09E). 
Then try the GIME chip, though that is less 
likely to cause this type of problem. Good 
luck! 

By the way, I will pay $20 for a known- 
dead Color Computer, provided its GIME 
chip is intact and has not succumbed due to 
a lightening strike or some other obvious 
disaster. (I'm looking for spare parts to fix 
a dead computer of my own.) Also, if you 
have no way of testing the 5 1 2K upgrade 
board you have, I will test it for you if you 
send it to me with a postage-prepaid, self- 
addressed box. You can send it to me at 
1633 Bayo Vista Ave., San Pablo, CA 
94806. Finally, 128K CoCo 3's are often 
offered for around S50 through the Classi- 
fied Ads section in the CoCo SIG on Del- 
phi. 



A There's a bug in the code for Ar- 
kanoid. I don't know of any fix for it. 
Sorry. 

Any number of things can cause a dead 
Color Computer, the most common being a 
bad 68B09E chip. Tied for second place arc 
malfunctioning memory chips and a bad 
board. Other things to check include whether 
the 51 2K memory board is properly seated 
and whether the GIME chip is properly in 
its socket. Sometimes merely removing the 
GIME chip from its socket, spraying the 
socket with contact cleaner and re-inserting 
it cures the problem. For more information, 
sec my response to Gil Brown in this issue. 

All Color Computer disk-drive systems 
use the same 34-pin female edge connec- 
tors on their ribbon cables, with the same 
assignment of signals. All CoCo floppy 
controllers that plug into the CoCo or Multi- 
Pak Interface use the same assignment of 
pins on their edge connector that the 34-pin 
drive cable connects to. Thus, a disk drive 
system from J&M should plug in just fine to 
a Tandy disk controller, and vice versa. The 
only possible difference I can think of is 
that some edge connectors use a "key" — a 
sliver of plastic between the inside walls of 
the connector — to insure proper alignment 
of the connector. Replacement connectors 
without such keys are commonly available 
at electronics stores. 

Problems With The WIZ 

^^k I'm having trouble with some files I 
^K^ downloaded from the OS-9 SIG on 
Delphi that stated they were to go with The 
WIZ terminal program. Can you help me? 
Bruce Moore (THUNDERFINGERS) 
Sterling, Virginia 

A The WIZ, a terminal program for OS- 
9, attempted (foolishly, 1 think) to 
introduce a new, incompatible variant of 
Xmodem. The altered protocol added an 
extra block (with information about the 
file) at the start of the file transfer. To 
download such files with other terminal 
programs, you'll need to strip off that first 
block. Such a "de-Wizzer" stripper pro- 
gram is available in the OS-9 SIG database. 
Alternatively, you can make use of the 
convenience the header offers by using The 
WIZ to download those files. 

Checking Things Out 

^^^ Are there peeks to see ifaCoCoi has 
^B^ 12HK, 5I2K or 1MB of memory in- 
stalled? Can I detect via software alone 
whether or not an RGB monitor is being 
used? Are there peeks to tell whether ADOS 
3 , Disk BASIC 1.0 or Disk BASIC I.I is in use 
in a given machine? Is there a way to use 
software to detect what kind of drive (35- or 
40-track, single- or double-sided) is con- 
nected to the computer? 

Bob Williams (BAWILUAMS) 
Ceder Hill, Missouri 

A Memory size can be determined via 
software alone. The principle is as 
follows: In a I28K CoCo, if you tell the 
memory management unit (MMU) to se- 



lect memory-block numbers $00, $ 10. $20 
or $30, you will be selecting the same 
physical space in RAM because memory 
blocks ghost on top of each other in a 1 28 K. 
CoCo (see "New Clear-screen Routines," 
June 1992, Page 1). On the other hand, if 
you have 5I2K, selecting these blocks 
specifies four different physical areas of 
memory. How might you use this informa- 
tion to determine memory size? After power 
up, enter POKE &HFFA2.0. This maps 
Memory Block into Slot 3 of Basic's 
memory map at $4000. Then enter POKE 
XH4000. 173 to put a given value (173) into 
location $4000. Now type POKE 
&HFFA2.&H10 to map Memory Block 16 
($10) into the same, part of BASIC'S memory 
map. Finally, enter PRINT PEEKf&HiOOO). 
If the CoCo returns 173, you're using a 
128K CoCo. If you get some other number, 
it means you have a 5 12K. or I-Mcg CoCo. 

You can use the same principle to distin- 
guish between a 512K and 1-Meg CoCo 3 
if you understand that, on a 5 1 2K machine, 
memory blocks $40 through $7F are the 
same as memory blocks $00 through S3F 
on a 512K CoCo 3. They arc separate 
memory blocks on a 1-Meg CoCo 3. 

When you have finished testing, it might 
be a good idea to return Location SFFA2 to 
its default value of $3A (just enter POKE 
&HFFA2.SH3A). It is also critical that you 
understand the general theory of how the 
MMU in the CoCo 3 works in order to 
really understand what is going on here. 
Since 1987, several articles covering this 
topic have appeared in THE RAINBOW, and 
the CoCo 3 service manual from Tandy al so 
contains this information. 

There is no way to check for the pres- 
ence of an RGB or composite video moni- 
tor using software. (In my opinion, this is 
good, for such automatic checking would 
be fraught with problems had it been imple- 
mented). Many authors get around this by 
asking the user which type of monitor he is 
using. 

Checking for DOS types can be done by 
looking at the Disk basic ROM itself. 
Memory Locations SCI 39 thru SC191 
contain the copyright message for Disk 
basic 1.1. Locations $C126 thru $C17D 
contain the copyright message for Disk 
BASIC 1 .0. By peeking at what is there, you 
can compare the contents you find to what 
you would expect with cither version of 
Disk BASIC. When it comes to variant disk 
ROMs, things can get a little trickier. ADOS 
comes in three main versions (ADOS. 
ADOS3 and Extended ADOS 3). Even 
worse, users can customize their own ROM 
sign-on message, and although they are 
advised to at least leave the version number 
in the same part of memory, they some- 
times ignore this advice. You may want to 
consult with Art Flexser (author of ADOS) 
on Delphi about the best way to lest for 
ADOS versions. Note that whatever test 
you use, you may need to have an excep- 
tion-handling routine to deal with the case 
of unknown DOS versions where it finds 
one or another version of, say, JDOS, 
M YDOS or some other variant. 

There's no simple way to test for what 
kind of a disk drive is hooked to the CoCo 
without putting a disk in the drive and 
trying to formal, read from, and write to 
parts of that disk. With a drive merely 
connected to the CoCo but with no disk in 
it, there is no way the CoCo can tell what 
sort of drive it is. All the CoCo can do is tell 
a disk drive lo read a track or sector, wrile 
a track or sector, move the head to position 
zero, or attempt to step the head one posi- 
tion up or down. While the CoCo does 
know (is told) when the head is at Track 0, 
it is not told when the head is at the last 
possible position. So if you step the head of 



a 40-track drive from Track to Track 79, 
it will repeatedly bang against the end slop. 
The CoCo has no way of knowing this is 
happening; for all it knows, the head is 
properly stepping in response to its com- 
mand. 

The DMP-130 and the PC 

^^^ /'/// having trouble connecting </ 
^^ Tandy DMP-130 to an IBM com- 
puter via the parallel port. Any sugges- 
tions? 

Eric Stroh (COCOS I2K) 
Thornton. Illinois 

A This problem has come up many times 
with the DMP-130 series of printers. 
Tandy uses a different implementation of 
the Centronics parallel port than the inter- 
national standard — Tandy put the prinler- 
initialization line on Pin 33 of the printer's 
connector, while every one else uses Pin 3 1 
and grounds Pin 33. Hence, when you use a 
normal cable to connect a DMP- 1 30-series 
printer lo an IBM PC or comaptible, the 
printer totally locks up. There a number of 
ways to fix this. The easiest is to simply 
make a special modification in your paral- 
lel printer cable. Inside the cable connector, 
cut the wire that goes to Pin 33 of the printer 
connector. The printer should then work 
fine when used with this cable. 

If you want to get fancy, you could 
reverse the wires that go to pins 33 and 3 1 
on the cable. In that case, be very careful to 
label that cable "For use with DMP- 1 30- 
series printers only." This latter approach 
preserves the printer-initialization option 
via the printer port — something not pre- 
served with the simple wire cut. However, 
very few applications need to use the printer- 
initialization option, so it should not be a 
big deal if you disable ii by doing the simple 
cable modification of cutting the single 



Where is Track 17? 

^^k When you use software that supports 
^^^. 40- and 80- track drives, is the direc- 
tory track still located on Track 1 7, or is it 
moved? 

Charles A. Marlow (CHARLES AM) 
Massapequa. New York 

A All the software I've ever seen that 
supports 40- and 80-track drives keeps 
the directory on Track 17 to preserve com- 
patibility. This is certainly true of ADOS 
md ADOS 3. 



Martin H. Goodman. M.D., a physician 
trained in anesthesiology, is a longtime 
electronics tinkerer and outspoken com- 
mentator — sort of the Howard Cosell of 
the CoCo world. On Delphi, Marty is the 
SIGop of THE rainbow's CoCo SIG. His 
non-computer passions include running, 
mountaineering and outdoor photography. 
Marty lives in San Pablo, California. 




Pressing the Reset button on the rear of 
the CoCo 3 does not clear the computer's 
memory. Yet turning the machine off and 
on again causes undue wear and tear. To 
completely reset the CoCo 3, erasing any 
programs in ils memory, enler 

P0KE113,0:EXEC &I-8C1B 
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A User's Experiences 
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ast month I shared some of my experiences in setting up OS-9/68000 and my 
impressions of how it works, explaining some differences between OSK and OS- 
9/6809 commands. This month we'll continue that path, looking deeper into the 
system. As you read this, however, bear in mind that the 68000-based computer 
I have is the MM/1 . Certain specifics may differ if you are using a different OS- 
9/68000-based machine. 



For those of you who are into C pro- 
gramming, the new Microware C compiler 
that comes with OS-9/68000 is good. In- 
cluded on ihe disk with I he C compiler are 
a sample program (makefile), make, the 
Microware assmbler !>68), the linker (1 68), 
and the debugger ( d e b u g ) . If you don ' t use 
the make utility under Level II on the CoCo 
3, 1 recommend you do so with OSK. The 
sample makefile, shown in Figure 1, is 
straightforward and easily expanded. 

The first thing you will notice is that it 
isn't like the makefile under C on the 
CoCo 3. To me. the OSK makefile is 
simpler and easier to use. No longer do I 
have to tell it which header files to use; it 
gets ihose from the C source code. Also, 
commands such as attr can be used from 
within the makefile. An example is mak- 
ing a C library. Just add 



library. 1: file.r file.r file.r 
merge >-file.r file.r file.r 

right after the attr statement and add 1 i - 
brary.l in the link statement. Once you 
have made a library file, you could put it in 
the /dd/LIB directory and use it just like 
any other library file. I am putting together 
a library file that I call uix.l; in it are 
modules that emulate Unix calls. This will 
come in handy for porting C code from a 
Unix system to OSK. 

Notice the line in the makefile that 
starts the compiler: 

cc -qrt-/r0 sample. c 

The options used are -q, for the Quiet 
mode; - r, to make a linkable module; and - 
t-/ rO, which tells the C compiler to use the 



# Sample Make file for test.c 
it 

Sample: sampler 

168 /dd/defs/cstart.r saple.r /dd/1 ib/cl ib. 1\ 

/dd/l1b/clibn.l /dd/lib/sys.l 

attr sample -pee sample 

§ 

# sample program compile 
# 

sample. r: sample. c 
cc -qrt=/r0 sample. c 

Figure 1: Sample ma kef i l e 



RAM disk for temporary files. 

The RAM disk is included in the MOD- 
ULES directory on my system. If you initialize 
/rO (by entering i ni z rO). OSK sets up a 
425K RAM drive. This alone greatly 
speeded up my C compiling 100 times. 
Before I started using /rO. it would take 
anywhere from 5 to 10 minutes to compile 



a simple program. Now it takes only about 
a minute to compile the same program. I 
understand that once I get the I/O board 
(with an additional two megabytes of 
memory) from IMS. compiling gets even 
fasier. [Editor's Note: The author wrote 
this article prior to receiving the I/O board 
for his MM/ 1. Soon after our decision to 




Bturigc & RorBe 



P.O. Box 733 Maple Valley, WA 98038 
U.S. ORDER DESK: (800) 237-2409 
INT'L & TECHNICAL: (206) 432-1814 

Boost your CoCo with these fine Burke & Burke products: 

THEXDER.OS9 - NEW FOR OS9. Use your TANDY™ $29.95 

Thexder cartridge under OS9. By Alan DeKok. 

The 6309 Book - 6309 programming hook by Chris Burke. $24.95 

Includes XSM assembler, disassembler, and DEBUG patches 
for OS9 Level 2. 

PowerBoost - 2 MHz enhanced HD63B09E processor wl OS9 $29.95 

kernel and I/O patches (10% - 50% speed improvement). Note: 
soldering required for installation. 

WORLD CLASS CHESS* - Use Cyrus Chess cartridge w/L2 OS9 $29.95 

FILE SYSTEM REPACK 1.1 - Faster OS9 disk defragment er $29.95 

FILE RECOVERY SYSTEM -Helps recover files from OS9 disks. $24.95 

R. S. B. * - DM BASIC for Level 2 (BASIC ROM required). $39.95 

EZGEN 1.10- EVEN FASTER! Handy & powerful OS9 bootfde editor $19.95 

WILD & MV - Use wildcards with OS9 commands: movefiles $19.95 

PERTASCII - Challenging OS9 game to make words from a list of $19.95 

j random letters. Play against the computer, multi-user, or BBS. 
ZCLOCK - Continuous time / date display on Level 2 screen $9.95 

COCO XT - Use PC MFM or RLL hard drives with CoCo! OS9 S/W $69. 95 
included (add $30 for COCO XT-RTC version with real-time clock; add 
$20 for XT-ROM hard disk uilto-boot ROM). 

DAGGORPATCH -Transfers TANDY™ Dungeons oj Daggorath $9.95 

cartridge to DISK BASIC. Adds disk I/O. screen dump, repeat. 

WA RESIDENTS ADD 8.2* SALES TAX. MasterCard & VISA accepted. U.S. COD's add 

$3.75. Min. U.S. shipping $4.00. Min. to Canada $5.00. Please allow 2 weeks for delivery. 

Overniglil or 2nd- day available for in-stock items. Software upgrades S5.00 eaeh w/receipl. 

including U.S. shipping. 

Call or write for a free catalog of more exciting Color Computer products! 
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SOLITAIRE CARD GAMES 

D ii o D e c k : Double Deck Solitaires . 

Play Sly Fox or Windmill - both games of skill. $19.95 

Classic Solitaire: Klondike, Canfield and Pyramid 
on one disk for just $1 4.95 

La Belle Lucie: A true game of skill. $14.95 

All three play on 128K CoCo3, with joystick and disk. 

SAVE $10.00. BUY ALL THREE FOR $40.00 




CRAZY 8's 
CBVSA8.2 



Play against your computer. 

Up to three opponents. All 

graphics, for all ages. Coco3. 

$14.95 



PACDUDE 3-D! 

What did the folks at the 

Atlanta CocoFest have to say 

about PACDUDE 3-D? 

Incredible! 

Find out why even hardcore OS9ers 
said "I have to have this program." 

Author: Brian O'Neill 

Runs on any 51 2K CoCo3. Requires joystick and disk drive. $1 9.95 




Checks, Money Orders, MasterCard & Visa $2.50 S&H 
COD $2.00 extra. WA addresses add 8.2% sales tax. 



[(206) 653-5263) 

30 day money back guarantee 



Eversoft Games, Ltd 

P.O. Box 3354 
Arlington, WA 98223 



ADVENTURE SURVIVORS! 

This is your newsletter! Only $6 per 

year. Reviews, solutions, and more! 

Call or write for details. 



L.E. Padgett 

24 Perthshire Dr. 

Peachtree City, GA 30269 

(404) 487-8461 
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publish the article was made, he received 
the hoard. For his initial experiences with 
a complete system, see the sidebar "The 
I/O Board Arrives. " ] 

Another feature of / rO is that you do not 
have to format it. Once you enter i ni z rO, 
the RAM drive is ready to go. On a 1 -Meg 
system with the RAM disk in operation, 
you'll have 267K of free memory, which is 
still more, than enough memory for most 
jobs. 

Also included with the MM/1 is Mi- 
croware Basic, a version of BASIC that is 
almost identical to BAS1C09 under Level I or 
II on the CoCo. The difference is that Mi- 
croware Basic does not include graphics 
support — Microware does not include a 
gf x or gf x2 module. You do, however, get 
syscall, inkey and runb. And 1 under- 
stand a begf x module (for KWindows) is in 
the works. 

One of the things I like about Microware 
Basic is that, because of the way OSK 
works, I can use far more memory with it 
than with BASIC09. UnderOS-9 Level II, the 
maximum memory size I could assign to 
BASIC09 is 42K. With Microware Basic and 
OSK, I can easily start with a workspace 
size of, say, 1 00K. Given the I/O board with 
additional memory, I could expand this to a 
megabyte and still have plenty of room for 
loading machine-code modules outside that 
workspace. If you use BASIC09, you'll have 
no trouble using Microware Basic. 

The MM/1 comes with the KWindows 
windowing system. Because this system is 



designed to make it easier for OS-9 Level TT 
users to switch, the graphic primitives and 
escape sequences are almost identical to 
those in Level II. I signed onto a RiBBS 
bulletin board, and it opened and closed an 
overlay window on my MM/1 without any 
trouble. 

Of course there are some differences, 
one of which involves screen types and 
resolutions. Using escape, sequences or the 
cgf x . 1 library, you can create eight differ- 
ent types of windows with KWindows (see 
Figure 2). The VSC chip in the MM/1 
supports a 720-by-560-pixel screen, but I 
understand that such modes are accessible 
only through assembly language. The 
higher-resolution graphic modes shown in 
Figure 2 are interlaced, a process by which 
multiple scans are used to create one dis- 
play. 

The thrust of the MM/1 is toward CD-I, 
which uses graphics images in the .IFF 
format. An . IFF vieweris included with the 
MM/1 , along with a .GIF to .IFF converter. 
.IFF files provide a higher resolution than 
.GIF; many of the .IFF files 1 have look a 
like photographs when displayed. Another 
type of graphic file supported by the MM/ 
1 are . KL1 (flicker) animation files. 

There are many advantages to OS-9/ 
68000. The larger memory map means you 
don't have to worry near as much about 
running out of memory. The higher clock 
speed (1 6 MHz) allows your programs to 
run faster and paves the way for excellent 
graphics and animation effects. The SCSI 



hard-disk controller is extremely fast. The 
higher screen resolution and greater num- 
ber of colors allows more flexibility in your 
graphics. 

On the software side, since Microware 
Basic is very similarto BASIC09, it should be 
easy to port any BASIC09 programs you 
have. Because it was designed with porta- 
bility in mind, most C programs from OS- 
9 Level II should present no problem either. 
And C for OSK is very similar to C on Unix 
systems, making it a relatively simple matter 
to port most ofthat software. 

OS-9/68000 V2.4 is very popular in 
Europe and Asia. For this reason, many 
programs have been ported to OSK. A 
series called TOPS is available from Eu- 
rope and includes applications, utilities, 
games and even another Shell . Most of this 
software includes source code, so bug fixes 
and enhancements can be made. 

Finally, I am already seeing many useful 
programs ported to OSK. Two of these are 
CS and RCS. The first is a popular Unix 
spreadsheet, and the second is a revision- 
tracking system many programmers use to 
keep track of the modifications, bug fixes 
and enhancements they make to programs. 
Also available is anotherCcompileras well 
as a C++ compiler. 

[f you are contemplating a move to OS- 
9/68000, make sure you consider the vari- 
ous systems that are' available: the MM/1 
from Interactive Media Systems, the Sys- 
tem IV from Delinar and the TC-70 from 
Frank Hogg Labs. They all use OS-9/68000 
V2.4, but for the most part, the similarity 
stops there. Each system uses its own inter- 
nal bus, giving it certain advantages. For 
more information about the MM/1 and the 
System IV, see the reviews in thf. rain- 
bow (December and September 1991 is- 
sues, respectively). 

The final decision is yours. Hopefully 
my I/O board will arrive soon so I can get 
my hard disk up an running. Then I can 
really begin taking avantage of OSK's 
power and* the programs that are just wait- 
ing to be used. 



Stevenson Services. In addition to working 
with computers, his hobbies include ama- 
teur radio, model railroading and sailing. 
John's Delphi username is VAXF.LF. 



John Donaldson is a software engineer 
in the gas-turbine division of Stewart & 
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byte is one of those odd little things 
computers use. It is a physical entity 
— a group of eight binary digits; electrical 
impulses — yet you ' 1 1 probably never actu- 
ally see one. Of course you can see the 
character represented by those eight bits 
that form a byte. And this is really all that's 
important. 

Bytes is a BASIC program 1 wrote to 
illustrate what bit combinations are used to 
represent different ASCII characters. When 
you run the program, you see a quick over- 
view of how a byte works, then you are 
asked to enter values between and 255. 
Bytes shows you the actual character for the 
value along with its binary value. If you 
press N when asked if you want to enter 
another value, you are prompted to press 
keys on the CoCo keyboard, for which 
Bytes displays the proper values. 



Keiran Kenny's interests lie mainly with 
the Color Computer's graphics and math 
capabilities. But in his own words. "I like to 
try everything." He may be contacted at 
van MontfoortlaanJ 1 , 2596 SP The Haque, 
Holland: 



The Listing: BYTES 

1 'BYTES 

2 'BY KEIRAN KENNY 

3 'COPYRIGHT (C) 1992 

4 'BY FALS0FT, INC. 

5 "RAINBOW MAGAZINE 
10 CLS 

20 PRINT@42,"**BYTES**" 

30 PRINT@193,"BY KEIRAN KENNY. S 

YDNEY. 1989." 



40 GOSUB340 

50 CLS:PRINT@96."A BYTE IS LIKE 
A ROW OF EIGHT SPOTLIGHTS. EAC 
H LIGHT IS A BIT. WHEN ALL ARE ON 

THEY REPRESENT 255 AND THE BIN 

ARY NUMBER " : 

60 X=294:C=256:GOSUB260:GOSUB340 
70 CLS 

80 PRINT@128."WHEN ALL LIGHTS AR 
E OFF THEY REPRESENT ZERO AND 

THE BINARY NUMBER ";:X=294 

:C=0:GOSUB260:GOSUB340 
90 CLS:PRINT@32."IN VARIOUS COMB 
INATIONS OF ON AND OFF THEY RE 
PRESENT THE CHAR-ACTERS ON YOUR 
KEYBOARD AND MANY0THER CHARACTER 
S. FOR INSTANCE THE LETTER 'A' 

IS DECIMAL 65 ANDBINARY ":X=2 

Q4:C=66:GOSUB260:GOSUB340 

100 CLS:PRINT@32. "INPUT A DECIMA 

L NUMBER IN THE RANGE 0-255";: 

INPUTT 

110 IFT>255THENCLS:PR:NT@32."MAX 

1MUM 2bb. IRY AGAIN .": F0RU-1 1010 

00:NEXT:GOTO100 

120 T$=RIGHT$(STR$(T),LEN(STR$(T 

))-l):D$="CHR$("+T$+")/CHR$UH"+ 

FFX$(T)+")" 

130 IFT<330RT=143THENPRINT@128,D 

$+" \|0T VISIBLE"ELSEPRINT@131.D$ 

+" - "+CHR$(T) 

140 PRINT0196. "BINARY "+T$+" -" : 

:X=294:IFT=0THENC=T:GOSUB260:ELS 

EC=T+1:GOSUB260 

150 GOSUB330 

160 IFK$="Y"ORK$="y"THEN100 

170 IFK$="N"0RK$="n"THENCLS:G0T0 

190 



180 GOTO150 

190 PRINT-PRESS ANY KEY ON YOUR 

KEYBOARD EXCEPT <BREAK>. USE TH 

E <SHIFT> KEY AND LOWER CASE TOO 

.":GOSUB350 

200 T$=RIGHT$(STR$(ASC(K$)).LEN( 

STR$( ASC( K$ ) ) ) -1) : IFASC( K$ X330R 

ASC(K$)>122THENPRINT@131."KEY";E 

LSEPRINT@131.K$; 

210 PRINT" = CHR$("+T$+")/CHR$(& 

H"+HEX$(ASC<K$))+">" 

220 PRINTS195. "BINARY "+T$+" -": 

X-294:C-ASC(K$)+1:GOSUB260 

230 PRINT@354."N0W ANOTHER KEY 

R <BREAK> TO END PROGRAM." 

240 GOSUB350 

250 IFK$OCHR$(3)THEN200ELSEEND 

260 FORP-7TO0STEP-1 

270 IFC>-(2"P)THENPRINT@X,CHR$(1 

59);:PRINT@X-33.1; 

280 IFC<(2 A P)THENPRINT@X.CHR$(12 

8);:PRINT@X-33,0;:GOTO300 

290 C-C-(2"P) 

300 X=X+2 

310 NEXTP 

320 RETURN 

330 PRINT@424."AN0~HER? Y/N":G0T 

0350 

340 PRINTS424. "PRESS ANY KEY"; 

350 K$=INKEY$: IFK$-""THEN350ELSE 

RETURN 
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After 1 had written and submitted to the 
rainbow my experiences with OSK and 
the MM/1 , the I/O board I needed to com- 
plete my system arrived. Before the follow- 
ing weekend was out, I had installed an 
additional two megabytes of memory and a 
1 30-Meg Maxtor SCSI hard drive. 

The MM/1 manual caused some confu- 
sion regarding just how to install the I/O 
board; how you should orient the board in 
order to set the jumpers correctly was a little 
unclear. After a few unsuccessful attempts, 
however, I was able to get the jumpers in the 
right place, and the MM/1 booted fine with 
the 3 -Meg Boot Disk supplied by IMS. 

Once, fwas online, with three megabytes, 
I created a new 0S9Boot file using the New 
Modeul Upgrade from IMS. After this, I 
added the hard-disk modules (hO and dd_h0) 
to the bootfile. (For the sake of safety, I 
decided to exclude the dd__hO descriptor 
until 1 was sure the drive would format and 
operate properly.) 

To format the hard drive, 1 first used the 
att r command to set the execute attibute of 
the hOfmt module and loaded that module 
into memorv. Then I entered f nrmat/hOfmt. 
The SCST interface used by the MM/1 is 
intelligent — the system determined the 
drive parameters by checking the drive 
before starting the format. When finished, I 
had a clean hard drive with jusi over 127 
megabytes of free space. Once formatted, it 
was a simple matter to create appropriate 
directories (CMDS, SYS, etc.) and copy the 
files from the 3 ! /2-inch disks that came with 
the MM/1. Finally, I created a new boot 
disk, replacing the dd_dO module with 
ddjrf). 

The stock EPROMs on the MM/1 proc- 
essor board include code to support hard 
drives but are not capable of booting the 
system directly from a hard drive. Thus, 
you need to use a floppy boot disk just as 
with OS-9 Level II hard-drive systems on 
the CoCo 3. (IMS does offer a replacement 
EPROM set that first looks to the floppy 
drive for a boot disk. If no fioopy boot disk 
is present, the code in these EPROMs tries 
to ooot the system from the hard drive.) 

With the I/O board installed, it was time 
to play with the other features it includes: 
stereo sound, mouse support and a printer 
port. The MM/1 sound capabilities are 
impressive. The port can be used to drive a 
pair of mini-speaKers and provides enough 
oomph that, in most cases, you won't need 
to add an amplifier. The set of speakers I use 
has a built-in amp but no volume control, so 
I leave the amp turned off. (I do plan to add 
a volume control in the near future, though.) 
The sound-input side works equally well, 
but it does require a fairly large input volt- 
age — it won t work if you simply connect 
a microphone to the port. 

The original and updated mouse drivers 
are hard coded to work with the / L2 serial 
port. These drivers are designed for use 
with a Logitech C7-type (or" compatible) 
mouse, although IMS now offers a mouse 
driver that supports the Microsoft serial 
mouse. I like the three-button Logitech 
mouse and recommend it for other users. 
As a side note, the newer version of KWin- 
dows supports a keyboard mouse that uses 
the numeric keypad. 

The printer port (/p) works very well, 
and IMS is working on a modification to 
allow use of the second included port. To 
help those who have printers without a DIP 
switch to control linefeed settings, there is 
a jumper on the I/O board that handles this. 

Now that I have a complete system. I am 
very pleased with the MM/1. Its speed is 
very impressive, and programs load and 
execute very quickly. And I like the way 
OS-9/68000 works. Best of all, I just learned 
that the TC-70 from Frank Hogg Labs will 
soon support KWindows. This means even 
more software for all of us OSK users. 
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DELPHI- The $1 per hour online solution! 



DELPHI'S 20/20 Advantage Plan sets the standard for online value: 
20 hours for only $20, for all the services you want! 

• Thousands of files to download. 

• Chat lines with hundreds of participants. 

• Worldwide e-mail. 

• Hobby and computer support groups. 

• Multi-player games. 

• Local access numbers 
in over 600 cities and towns. 



Irial Offer: 5 hours for $5! 

Try DELPHI at $1 per hour. Join today and get 5 hours of evening and weekend 
access for only $5. If you're not satisfied, simply cancel your account before the 
end of the calendar month with no further obligation. Keep your account active 
and you'll automatically be enrolled in the 20/20 plan for the next month. 

1. Via modem, dial 1-800-365-4636. 

2. When connected, press RETURN once or twice. 

3. At Password, enter RB55 

Questions? Call 1-800-695-4005. 

Rates apply for evening and weekend access from within the mainland US. There is a one-time enrollment fee of $19 
when you join the 20/20 Advantage Plan. Further details are provided during the online registration. 





DELPHI is a service of 

General Videotex Corporation 

1030 Massachusetts Avenue 

Cambridge, MA 02138-5302 

800-695-4005 • 617-491-3393 
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Financial Software 





The CoCo has long been a hard worker 
when it comes to managing personal fi- 
nances. And it's no slouch in a small-busi- 
ness environment either. If you have writ- 



ten a program you 
use for laking care 
of dollars and cents, 
perhaps someone 
else could use it, too. 
We are now 
making tentative 
plans for itie April 
1 993 issue of I lit RAINBOW and are accept- 
ing program submissions appropriate for 
that issue's theme, Finances. We are also 
interested in general-interest articles dis- 



cing now people use the CoCo in finan- 
cial sellings. All submissions must be re- 
ceived by us no later than December 28, 
1992, and must follow our standard sub- 
mission guidelines (see Page 8 for details 
and address). 

We ' d a I so I i ke to see any other programs 
you have written (submilled material must 
be the original work of the submitting party, 
or submitted with written permission). All 
submissions are evaluated arid considered 
for publication in future issues. 




RACK ISSUES STIIJ . AVAILABLE United Parcel Service. There is a S3 charge 
Have you explored the wealth of information for the first issue, pins a S I charge for each ad- 

page issue to many with more than 300 pages U i'S will not deliver to a post office box or to 
of .material, it's all just for CoCo. users — a another countrv. 
s^rcal way io expand vour libr^rvj -„„.; Z" ., " ""' 5 J 

MOST ISSUES 
A WOULD OF.INFO 
AT A BARGAIN PRICI 

lean Express 
cfhis for each addi- Kentucky residents please add 6 percent sales • 
lional issue for postage and handling if sent by tax: Canadian residents. ? percent GST. In 



Due to haavj demand, we sujgest you order 
the back issue's sou want now while supplies 
last. ..... » .. « 

order, review anil fill out the form below 




RAINBOW INDEX 

A complete index for, July 1981 through June 1984, is printed in 
the July 1 984 issue. Separate copies are available for $2.50 plus 50c 
handling. Indexesfor subsequent years are published annually in the 
July issues of the rainbow. 

TOTAL 

KY RESIDENTS ADD 5% 

CANADIAN RESIDENTS ADD 7% GST 

U.S. MAIL CHARGE 

SHIPPING & HANDLING 



U.P.S. CHARGE 

TOTAL AMOUNT 

ENCLOSED 



Article Reprints 

In instances where a given issue is now oul ol print and not available lor 
purchase, we do provide photocopies of specific articles. The ccst for this 
service is $1 .50 plus 50 cents S/H per article. This service is provided only \r* 
the case of out-of-stock issues. 

Name 

Address 

City State Zip 

J Payment Enclosed. orCharge to my: J VISA 
Card# 



J MC JAE 



Expiration Date 
Signature 



Pnone I 



TO ORDER BY PHONE (credit card orders only) call (800) 847- 
0309, 9 a.m. to 5 p.m. EST. All other inquiries call (502) 228-4492. 
send to: THE RAINBOW, The Falsoft Building, P.O. Box 385, 
Prospect, KY 40059 

Please send me the following back issues: 





VOLUME 2 


JUN83 


Pnriers 




VOLUME 3 


AUG 83 


Games 


SEP 83 
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OCT 83 


Graphics 


MAR 84 


Business 
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VOLUME 4 

Games 
Education 
Graphics 
Data Comn-. 



S3 95 -l 
$3.95 J 
$3.95 3 
$3.95 J 



$3.95 J 
$3.95 J 
$3.95 J 
$3.95 J 



DEC 84 
„AN8E 
FEB 85 
MAR 85 
APR 85 
MAY 85 
.UN 85 
eUL85 



AUG 85 
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MAY 86 
J UN 86 
.UL86 



OCT 86 
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.AN 87 
FFB87 
MAR 87 
APR 87 
MAY 87 
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NOV 87 
UbC87 
JAN 00 
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JAN 89 
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Simulations 

Printer 

Music 

Anniversary 
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Holiday 



Anniversary 
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Holiday 
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Holiday 
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$3.95 3 
$3.95 J 
$3.95 3 
$3.95 -I 
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$3.95 J 
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$3.95 3 
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S3 95 3 
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$3.95 -i 
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$3.95 3 
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S3 95 3 
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$3.95 -l 
S3.95 3 
S3.95 3 
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S3 95 3 



$3 95 J 
$3.96 3 
$3.95 3 
$3.95 3 
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FEB 89 
MAR 89 
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AUG 39 
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Anniversary 
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OS-9 
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Anniversary 
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Printer 
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1.95 J 
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The following products have recently 
been received by THE RAINBOW, examined 
by our staff and issued the Rainbow Seal of 
Certification, your assurance that we have 
seen the product and have ascertained that 
it is what it purports to be. 

CoCo Cassette#120. a variety of programs 
for the CoCo ! , 2 and 3. This issue includes 
NameFile, a filer for addresses and phone 
numbers; Comics, a filer for comic-book 
collectors; Alphabet Soup, a game in which 
you try to align groups of letters onscreen: 
Budget, a complete home-finance program; 
Labeler, a label printer for disks; Kayak, a 
text-adventure game: JB-Robot, Appliance 
& Light Controller software for disabled 
persons; Destroyer, an arcade-style game; 
Satelite, another arcade-style game; Christ- 
mas Card List, a specialized address fi ler. T 
& D Subscription Software, 2490 Miles 
Standish Drive, Holland, Ml 49424. (616) 
399-9468; $8. 

KwikZap, a disk/file editor for OS-9 Level 
II. Features include string searches, a sector 
stack, header and CRC verification, mod- 
ule listings, a nibble mode and onscreen 
help. In addition, KwikZap supports its own 
user-definable environment. Requires OS- 
9 Level II. Gale Force Enterprises, P.O. 
Box 66036, Station F. Vancouver BC V5N 
5L4. Canada; $19.95 plus $4 S/H. 



The Rainbow Seal of Certification is 
open to all manufacturers of products 
applicable to the Tandy Color Com- 
puter, regardless of whether or not those 
companies advertise in THE RAINBOW. 
By awarding the Seal, we certify the 
product exists — we have a sample copy 
and have examined it. However, this 
does not constitute, any guarantee of 
satisfaction. As soon as possible, these 
products will be forwarded to review- 
ers for evaluation. 



■.eeunies: None. >i> Kir eivm'kl 
i/cd to mail at special rales (Section 423.12 DMM). Tlic purpose. 
function andnonproflt status of Ihisorgani2ation«nd the exempt status 
Iwhideral Income lax purposes iOicck,iiic;:Niiiapplieatu\ Hlj Extern 

preceding 12 months: ( Y)=Aciua No opieso sinoU i- >< «l i. 
nearest to thing date. Al Total No. ol >p.e> w -'' II.ssqij) 
5.300. B: Paid Cirtjlulion: USalesi'i ,1,'ji n..i >Ui -i,'i...ir;.-i 



i.«H\ h'l C,.|.„', n. I diMrrinilnl: I , office use. left ov, 

spoiled a lei pin v: U)-IK> IVI4K) 21 Returns from 

2365 (y)0. G) Total: , . I 1,559 (y) 5300. 



m:(x) 8.988 ft) 
r. unaccounted. 
tews agents: <x) 
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Premier 

Personal 

CompHter 

Majuine 

for Tandy 

Compiler 

Users 




Covering 
the Complete 
Line of Popular 

Tandy 
MS-DOS 
and Portable 
Computers 

Call (502) 228-4492 for information: 

(800) 847-0309 for VISA/MC/AMEX orders 

PCM is a registered trademark of Falsofi, inc. 



Advertisers Index 



Owl-Ware 7 

PCM : . ..; .„..., 19 ; 

R<pnbow Back Tssues 18 

Sundog Systems' ....':....: .....:. 5 

Sundog Systems 19 



Burke & Burke 15 

Dayton Associates 

of W.R. Halljnc 13 

Delphi 17 

Eversoft :.{..... % 15 

Granite 9 

Hawksoft ". 19 

Infinitum Technology 9 



We appreciate your mentioning rue rainbow when you contact these advertisers. 




Call Kim Lewis 
Eastern Sales Director 
(502)228-4492 



Call Ira Barsky 
Western Sales Director 
(312)587-1818 



The Falsolt Building 

9509 U.S. Highway 42, P.O. Box 385, Prospect, KY 40059 

(502) 228-4492 • FAX (502) 228-5121 



The Contras 

2 'years in the maSusc^. 

j3 cast of 3 all-star i»ragraKNCBK9tt&. 

77/E game. Here JiWa^.... 

Once upon a time, Sundog Systems announced a new 512k game called The 
Conlras. It took two years and three programmers to complete this, the most 
ambitious game ever created for the CoCo-3. Jeff Steidl, accomplished author of 
Photon and GrafExpress 2.0, led the effort to produce this technological marvel. In 
doing so, he proved that the CoCo can match -or surpass- any home game system. 

The Contras features a two-player cooperative mode, 512k filled with incred- 
ible graphics, super-smooth animation and scrolling, an outstanding background 
music score, sizzling sound effects, and lightning-fast arcade action. 

Thi3 is paramilitary combat at its best. Play alone or with a friend as you take 
on the evil alien invaders. Blow away the enemy while travelling thru multiple 
levels and powering up with ever more destructive weapons. The Contras will keep 
you playing for hours; it is quite possibly the best CoCo game ever! Requires 512k 
CoCo-3, disk drive, & joystick. ^Ofc AC 

Super jJumJog §ale! 

For this holiday season, Sundog is cutting prices on even our most 
popular products. Give more to your favorite CoCo gamer for less! You 
must mention this ad when ordering to get these very special prices! 
See our full-page ad elsewhere in this issue for prices & shipping info. 



10% off 2 or more 10% off 



GrafExpress 2.0 
Photon 

Kyiim-Gai (either ver.) 

Zenix 

Crystal City 
Sinistaar 
Quest for Thelda 



War Monger 
Soundtrax 
Warrior King 
Quest/Starlord 
All hint books 



>o 



50% off 

Hall/King 1,2, or 3 
Paladin's Legacy 
Kung-Fu Dude 
Champion 
Dragon Blade 
White Fire/Eternity 



r* ^c»« 



b* 



Vf**** 



k. 



Icon Bgs|c09 

The next programming language for OS-9! 

Icon Basic09 is agraphical user interface (GUI) to Basic09, which 
will make programming easier than ever! Icon Basic09 takes an 
innovative approach by using graphic representations, or icons, to 
represent statements and keywords for writing Basic09 programs and 
procedures. Instead of constantly typing while writing a program, the 
user can simply point & click to choose the desired statement! 

Icon Basic09 can also be very useful in studying procedures and 
programs written by others to learn how they operate. The package 
contains a full set of icons... or, you may edit or create icons using the 
included icon editor. Icon Basic09 requires a CoCo-3 with at least 256k, 
mouse or joystick, and OS-9 Iv 2. &f% 4% 

Dual hi-res joystick adapter (Rs/coiorware) $40 
Hi & Lo-res joystick adapter $27 

HAWKsoft keyboard extension cable $25 

Domination ("Risk"-like wargame!) $18 

MyDOS full-featured DOS extension $15 




awksoft 

PO Box 7112 



1L 



PO Box 71 1 2 

Elgin, IL 60121-7112 

(708) 742-3084 eves & ends 

US and CDN S&H always included. Terms: MO, check, or COD. 
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From Computer Plus to YOU . . . 
PLUS after PLUS after PLUS 





Tandy 1110 HD $739* 
Tandy 3800 HD $1559* 
Tandy 3830 SL $1749* 



Tandy 2500 RSXHD $749 
Tandy 4825 SX/25 HD $1 279* 




Tandy 4850 EP $1749* 







DMP-135$189* 



SIM 







Color Computer Disk Drive 
Drive $239 Drive 1 $1 49 




TandyFax 1020 $299* 



BIG SAVINGS on a full complement of radio shack computer products 



COMPUTERS 




COLOR COMPUTER MISC. 


Tandy 1 000 RSX FD,VGM 225 


559.00 * 


Tandy Drive Controller 


Tandy 11 10 HD1 Drive 640K 


739.00 * 


Extended Basic Rom Kit (28 pin) 


Tandy 3800 HD1 Drive 


1559.00 * 


64K Ram Upgrade Kit (2 or 8 chip) 


Tandy 2500 RSXHD 1 Meg RAM 


749.00 


Tandy Deluxe Keyboard Kit 


Tandy 3830 SL 1 Drive 2 Meg RAM 


1749.00 ' 


HI-RES Joystick Interface 
Color Computer Deluxe Mouse 


PRINTERS 




Multi Pak Pal Chip for COCO 3 


TandyDMP-136 213CPS 


199.00 * 


COCO 3 Service Manual 


Tandy DMP-302 270 CPS 


469.00 


Serial to Parallel Converter 


Tandy DMP-2021 80 CPS 


299.00 


Tandy Deluxe Joystick 


Tandy DMP-442 300 CPS 


539.00 


Magnavox 81 35 RGB Monitor 


Tandy LP-950 Laser Printer 


1299.00 


Magnavox Green or Amber Monitor 


Tandy DMP-240 1 92 CPS 8 color 


329.00 * 


CoCo3GimeChip 


Panasonic KXP 1 1 80 1 92 CPS 


189.00 * 


Tandy Pistol Grip Joystick 


Panasonic KXP 1 1 23 24 Wirehead 


259.00 * 


PBJ OK COCO 3 Upgrade Board 


Panasonic KXP 1 1 24 i300 CPS 


329.00 


PBJ 51 2K COCO 3 Upgrade 


Okidata320300CPS 


369.00 


Tandy OK COCO 3 Upgrade Board 


Okidata 380 1 80 CPS 24 Wire HD 


239.00 


Tandy 51 2K COCO 3 Upgrade 


OKI Laser 400 4PPM 


679.00 * 


COLOR COMPUTER SOFTWARE 


MODEMS 




TAPE 


Tandy DCM-6 


52.00 


The Wild West (COCO 3) 


Tandy DCM-7 


85.00 


Worlds of Flight 34.95 


Cardinal 1200 Baud External 


99.00 


Mustang P-51 Flight Simul. 34.95 


Cardinal 2400 Baud External 


129.00 


Flight 1 6 Flight Simul. 34.95 



89.00 
19.95 
39.00 
24.95 
8.95 
44.00 
14.95 
29.95 
59.95 
19.95 
299.00 
99.00 
29.95 
26.95 
29.95 
89.00 
39.95 
99.00 



DISK 

25.95 
34.95 
34.95 
34.95 



Tandy Educatioal Software 2.00 

Spinnaker Software 2.00 

MaxlObyColorware 79.95 

AutoTerm by PXE Computing 29.95 39.95 

TW-80 by Spectrum (COCO 3) 39.95 

Telewriter 64 49.95 59.95 

Telewriter 128 79.95 

Elite Word 80 79.95 

EliteCalc3.0 69.95 

CoCo3512KSuperRamDisk 19.95 

Home Publishing by Tandy (CoCo 3) 35.95 

SubBattleSim.byEpyx(CoCo3) 26.95 

ThexderbySierra(CoCo3) 22.45 

Kings Quest III by Sierra (CoCo3) 31 .45 

Flight Sim. II by SubLogic (CoCo 3) 31 .45 

OS-9 Level II by Tandy 71.95 

OS-9 Development System 89.95 

Multi-View by Tandy 44.95 

VlPWriter(diskonly) 69.95 

VIP Integrated Library (disk) 149.95 

Prices are subject to change without notice. Please call for 
shipping charges. Prices in our retail store may be higher. 
Send for complete catalog. 

"Sale prices through 12-10-92 



CALL TOLL FREE 
1-800-343-8124 

• LOWEST POSSIBLE PRICES 

• BEST POSSIBLE WARRANTY 

• KNOWLEDGEABLE SALES STAFF 

• TIMELY DELIVERY 

• SHOPPING CONVENIENCE 



com 




P.O. Box 1094 
480 King Street 
Littleton, MA 01460 

IN MASSACHUSETTS CALL (508) 486 3193 



SINCE 1973 



Tandy is a registered trademark ol Tandy Corp. 



